acmDriverEnum  1MKJI5L 

The acmDriverEnum function enumerates the available ACM drivers, continuing until there are no more drivers or the callback function returns FALSE.

MMRESULT acmDriverEnum(

    ACMDRIVERENUMCB fnCallback,

 

    DWORD dwInstance,

 

    DWORD fdwEnum

 

   );

 

 

Parameters

fnCallback

Procedure instance address of the application-defined callback function.

dwInstance

A 32-bit application-defined value that is passed to the callback function along with ACM driver information.

fdwEnum

Flags for enumerating ACM drivers. The following values are defined:

ACM_DRIVERENUMF_DISABLED

Disabled ACM drivers should be included in the enumeration. Drivers can be disabled by the user through the Control Panel or by an application using the acmDriverPriority3QRVIW function. If a driver is disabled, the fdwSupport parameter to the callback function will have the ACMDRIVERDETAILS_SUPPORTF_DISABLED flag set.

ACM_DRIVERENUMF_NOLOCAL

Only global drivers should be included in the enumeration.

 

Return Values

Returns zero if successful or an error otherwise. Possible error values include the following:

MMSYSERR_INVALFLAG

At least one flag is invalid.

MMSYSERR_INVALPARAM

At least one parameter is invalid.

 

Remarks

The acmDriverEnum function will return MMSYSERR_NOERROR (zero) if no ACM drivers are installed. Moreover, the callback function will not be called.

See Also

acmDriverPriority