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 DRV_OPEN message.

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

A client sends the ACMDM_DRIVER_DETAILS message by calling the driver’s DriverProc entry point, passing the specified parameters. The ACM sends this message when an application calls acmDriverDetails, which is described in the Win32 SDK.

Before the driver’s DriverProc 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.

For more information about custom icons, see Providing a Custom Icon.