ACMDM_DRIVER_NOTIFY

The ACMDM_DRIVER_NOTIFY message notifies an ACM driver of changes to other ACM drivers.

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_NOTIFY

lParam1

Not used.

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_NOTIFY message by calling the ACM driver's ACM_IOControl() entry point via DeviceIoControl(), each time a client calls the acmDriverAdd, acmDriverRemove, or acmDriverPriority function. (These functions are described in the Win32 SDK.)

ACM driver support for this message is optional. If the driver supports the message, it can call ACM API functions, such as acmEnumDrivers and acmMetrics, to determine which drivers have been added, removed, enabled, disabled, or had their priority changed.