acmDriverEnum

	Overview

	Group

	Quick Info

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 acmDriverPriority 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.