acmDriverEnum

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:

Value Description
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.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in msacm.h.
  Import Library: Use msacm32.lib.

See Also

Audio Compression Manager Overview, Audio Compression Functions, acmDriverPriority