acmDriverOpen

The acmDriverOpen function opens the specified ACM driver and returns a driver instance handle that can be used to communicate with the driver.

MMRESULT acmDriverOpen(
  LPHACMDRIVER phad,  
  HACMDRIVERID hadid, 
  DWORD fdwOpen       
);

Parameters

phad

Pointer to a buffer that receives the new driver instance handle that can be used to communicate with the driver.

hadid

Handle to the driver identifier of an installed and enabled ACM driver.

fdwOpen

Reserved; must be zero.

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_INVALHANDLE The specified handle is invalid.
MMSYSERR_INVALPARAM At least one parameter is invalid.
MMSYSERR_NOMEM The system is unable to allocate resources.
MMSYSERR_NOTENABLED The driver is not enabled.

Requirements

**  Windows NT/2000/XP:** Included in Windows NT 3.1 and later.
**  Windows 95/98/Me:** Included in Windows 95 and later.
**  Header:** Declared in Msacm.h.
**  Library:** Use Msacm32.lib.

See Also

Audio Compression Manager, Audio Compression Functions