acmFilterTagEnumCallback 函数指定与 acmFilterTagEnum 函数一起使用的回调函数。 acmFilterTagEnumCallback 函数名称是应用程序定义的函数名称的占位符。
语法
ACMFILTERTAGENUMCB Acmfiltertagenumcb;
BOOL Acmfiltertagenumcb(
HACMDRIVERID hadid,
LPACMFILTERTAGDETAILS paftd,
DWORD_PTR dwInstance,
DWORD fdwSupport
)
{...}
parameters
hadid
ACM 驱动程序标识符的句柄。
paftd
指向包含枚举筛选器标记详细信息的 ACMFILTERTAGDETAILS 结构的指针。
dwInstance
在 acmFilterTagEnum 中指定的应用程序定义值。
fdwSupport
特定于驱动程序标识符 ACMDRIVERDETAILS 结构的驱动程序支持标志。 此参数可以是以下值的组合，用于标识驱动程序使用筛选器标记支持的操作。
| 值 | 含义 |
|---|---|
| ACMDRIVERDETAILS_SUPPORTF_ASYNC | 驱动程序支持使用指定的筛选器标记进行异步转换。 |
| ACMDRIVERDETAILS_SUPPORTF_CODEC | 使用指定的筛选器标记时，驱动程序支持在两个不同的格式标记之间进行转换。 例如，如果驱动程序支持使用指定的筛选器标记从 WAVE_FORMAT_PCM 压缩到 WAVE_FORMAT_ADPCM ，则设置此标志。 |
| ACMDRIVERDETAILS_SUPPORTF_CONVERTER | 使用指定的筛选器标记时，驱动程序支持在同一格式标记的两种不同格式之间进行转换。 例如，如果驱动程序支持使用指定的筛选器标记重新采样 WAVE_FORMAT_PCM ，则设置此标志。 |
| ACMDRIVERDETAILS_SUPPORTF_FILTER | 驱动程序支持筛选 (修改数据，而无需更改) 的任何格式属性。 例如，如果驱动程序支持 WAVE_FORMAT_PCM上的卷或回显操作，则会设置此标志。 |
| ACMDRIVERDETAILS_SUPPORTF_HARDWARE | 驱动程序通过波形音频设备支持具有指定筛选器标记的硬件输入和/或输出。 应用程序应将 acmMetrics 函数与 ACM_METRIC_HARDWARE_WAVE_INPUT 和 ACM_METRIC_HARDWARE_WAVE_OUTPUT 指标索引一起使用，以获取与支持的 ACM 驱动程序关联的波形音频设备标识符。 |
返回值
回调函数必须返回 TRUE 才能继续枚举，返回 FALSE 才能停止枚举。
注解
如果未枚举筛选器标记， 则 acmFilterTagEnum 函数返回 MMSYSERR_NOERROR (零) 。 此外，不会调用回调函数。
不应从回调函数中调用以下函数： acmDriverAdd、 acmDriverRemove 和 acmDriverPriority。
要求
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | msacm.h |