acmDriverEnum 函数 (msacm.h)
acmDriverEnum 函数枚举可用的 ACM 驱动程序,一直持续到没有更多的驱动程序或回调函数返回 FALSE。
语法
MMRESULT ACMAPI acmDriverEnum(
ACMDRIVERENUMCB fnCallback,
DWORD_PTR dwInstance,
DWORD fdwEnum
);
parameters
fnCallback
应用程序定义的回调函数的过程实例地址。
dwInstance
64 位 (DWORD_PTR) 或 32 位 (DWORD) 应用程序定义的值,该值随 ACM 驱动程序信息一起传递给回调函数。
fdwEnum
用于枚举 ACM 驱动程序的标志。 定义了以下值。
值 | 含义 |
---|---|
ACM_DRIVERENUMF_DISABLED | 枚举中应包含已禁用的 ACM 驱动程序。 用户可以通过控制面板或使用 acmDriverPriority 函数的应用程序禁用驱动程序。 如果禁用驱动程序,则回调函数的 fdwSupport 参数将设置ACMDRIVERDETAILS_SUPPORTF_DISABLED标志。 |
ACM_DRIVERENUMF_NOLOCAL | 枚举中只应包含全局驱动程序。 |
返回值
如果成功,则返回零,否则返回错误。 可能的错误值包括以下内容。
返回代码 | 说明 |
---|---|
|
至少有一个标志无效。 |
|
至少有一个参数无效。 |
注解
如果未安装 ACM 驱动程序,则 acmDriverEnum 函数将返回MMSYSERR_NOERROR (零) 。 此外,不会调用回调函数。
要求
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | msacm.h |
Library | Msacm32.lib |
DLL | Msacm32.dll |