Partager via

ACMDM_DRIVER_DETAILS (Compact 2013)

  • Article

3/26/2014

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

Parameters

  • dwDeviceID
    Value that specifies a driver instance identifier. The driver returns this value in response to the ACM_Open (ACM Driver) function.
  • hDriver
    Handle to a driver.
  • uMsg
    Value that specifies this message.
  • lParam1
    Pointer to an ACMDRIVERDETAILS structure. This structure is declared in the Msacm.h header file.
  • lParam2
    Not used.

Return Values

MMSYSERR_NOERROR indicates success. Otherwise, the driver returns one of the MMSYSERR error values declared in the Mmsystem.h header file or one of the ACMERR error values declared in the Msacm.h header file.

Remarks

The ACM (Waveapi.dll) sends this message by calling the ACM driver's ACM_IOControl entry point through the DeviceIoControl function. The ACM sends this message when an application calls the acmDriverDetails function.

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

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

ACM drivers must support this message.

Requirements

Header

msacmdrv.h

See Also

Reference

ACM Driver Messages
ACM_Open (ACM Driver)
ACM_IOControl