ACMDM_DRIVER_DETAILS

The ACMDM_DRIVER_DETAILS message requests an ACM driver to return detailed information about itself.

Parameters

dwDriverID

Driver instance identifier. This is the value returned by the driver in response to the ACM_Open function.

hDriver

Driver handle.

uMsg

ACMDM_DRIVER_DETAILS

lParam1

Pointer to an ACMDRIVERDETAILS structure. ( ACMDRIVERDETAILS is defined in Msacm.h and described in the Win32 SDK.)

lParam2

Not used.

Return Value

The driver should return MMSYSERR_NOERROR if the operation succeeds. Otherwise it should return one of the MMSYSERR error codes defined in Mmsystem.h, or one of the ACMERR error codes defined in Msacm.h.

Comments

The ACM (WAVEAPI.DLL) sends the ACMDM_DRIVER_DETAILS message by calling the ACM driver's ACM_IOControl() entry point via DeviceIoControl(). The ACM sends this message when an application calls acmDriverDetails, which is described in the Win32 SDK.

Before the driver's ACM_IOControl function is called, the ACM verifies that lParam1 contains a valid pointer and that the ACMDRIVERDETAILS structure's cbStruct member contains a size value of at least four.

The driver should fill in the ACMDRIVERDETAILS structure members, up to the number of bytes specified by the cbStruct member.

ACM drivers must support this message.