ACMFORMATTAGENUMCBA 回调函数 （msacm.h）
acmFormatTagEnumCallback 函数指定与 acmFormatTagEnum 函数一起使用的回调函数。 acmFormatTagEnumCallback 名称是应用程序定义的函数名称的占位符。
语法
ACMFORMATTAGENUMCBA Acmformattagenumcba;
BOOL Acmformattagenumcba(
HACMDRIVERID hadid,
LPACMFORMATTAGDETAILSA paftd,
DWORD_PTR dwInstance,
DWORD fdwSupport
)
{...}
参数
hadid
ACM 驱动程序标识符的句柄。
paftd
指向包含枚举格式标记详细信息的 ACMFORMATTAGDETAILS 结构的指针。
dwInstance
acmFormatTagEnum 函数中指定的应用程序定义值。
fdwSupport
特定于格式标记的驱动程序支持标志。 这些标志与 ACMDRIVERDETAILS 结构
| 价值 | 意义 |
|---|---|
| ACMDRIVERDETAILS_SUPPORTF_ASYNC | 驱动程序支持使用指定的筛选器标记进行异步转换。 |
| ACMDRIVERDETAILS_SUPPORTF_CODEC | 驱动程序支持在两个不同的格式标记之间进行转换，其中一个标记是指定的格式标记。 例如，如果驱动程序支持从WAVE_FORMAT_PCM压缩到WAVE_FORMAT_ADPCM，则会设置此标志。 |
| ACMDRIVERDETAILS_SUPPORTF_CONVERTER | 驱动程序支持在指定格式标记的两种不同格式之间进行转换。 例如，如果驱动程序支持重新采样WAVE_FORMAT_PCM，则设置此标志。 |
| ACMDRIVERDETAILS_SUPPORTF_FILTER | 驱动程序支持筛选器（在不更改任何格式属性的情况下修改数据）。 例如，如果驱动程序支持对指定格式标记执行卷或回显操作，则设置此标志。 |
| ACMDRIVERDETAILS_SUPPORTF_HARDWARE | 驱动程序通过波形音频设备支持硬件输入、输出或两种指定格式标记。 应用程序应将 acmMetrics 与ACM_METRIC_HARDWARE_WAVE_INPUT和ACM_METRIC_HARDWARE_WAVE_OUTPUT指标索引配合使用，以获取与支持 ACM 驱动程序关联的波形音频设备标识符。 |
返回值
回调函数必须返回 true 才能继续枚举或 FALSE 停止枚举。
言论
如果未枚举任何格式标记，acmFormatTagEnum 函数将返回MMSYSERR_NOERROR（零）。 此外，不会调用回调函数。
不应从回调函数中调用以下函数：acmDriverAdd、acmDriverRemove，acmDriverPriority。
注意
msacm.h 标头将 ACMFORMATTAGENUMCB 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 支持的最低服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | 窗户 |
| 标头 | msacm.h |