aCMDRIVERENUMCB 回调函数 (msacm.h)
acmDriverEnumCallback 函数指定与 acmDriverEnum 函数一起使用的回调函数。 acmDriverEnumCallback 名称是应用程序定义的函数名称的占位符。
语法
ACMDRIVERENUMCB Acmdriverenumcb;
BOOL Acmdriverenumcb(
HACMDRIVERID hadid,
DWORD_PTR dwInstance,
DWORD fdwSupport
)
{...}
参数
hadid
ACM 驱动程序标识符的句柄。
dwInstance
在 acmDriverEnum 中指定的应用程序定义值。
fdwSupport
特定于 由 ACMDRIVERDETAILS 结构指定的驱动程序的驱动程序支持标志。 此参数可以是以下值的组合。
| 值 | 含义 |
|---|---|
| ACMDRIVERDETAILS_SUPPORTF_ASYNC | 驱动程序支持异步转换。 |
| ACMDRIVERDETAILS_SUPPORTF_CODEC | 驱动程序支持在两个不同的格式标记之间进行转换。 例如，如果驱动程序支持从WAVE_FORMAT_PCM压缩到WAVE_FORMAT_ADPCM，则会设置此标志。 |
| ACMDRIVERDETAILS_SUPPORTF_CONVERTER | 驱动程序支持在同一格式标记的两种不同格式之间进行转换。 例如，如果驱动程序支持重新采样WAVE_FORMAT_PCM，则会设置此标志。 |
| ACMDRIVERDETAILS_SUPPORTF_DISABLED | 驱动程序已被禁用。 应用程序必须使用 acmDriverEnum 指定ACM_DRIVERENUMF_DISABLED标志，才能在枚举中包含禁用的驱动程序。 |
| ACMDRIVERDETAILS_SUPPORTF_FILTER | 驱动程序支持筛选 (修改数据，而无需更改) 的任何格式属性。 例如，如果驱动程序支持WAVE_FORMAT_PCM上的音量或回显操作，则会设置此标志。 |
返回值
回调函数必须返回 TRUE 才能继续枚举，返回 FALSE 才能停止枚举。
注解
如果未安装 ACM 驱动程序，则 acmDriverEnum 函数将返回MMSYSERR_NOERROR (零) 。 此外，不会调用回调函数。
不应从回调函数中调用以下函数： acmDriverAdd、 acmDriverRemove 和 acmDriverPriority。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | msacm.h |