ACMFORMATENUMCBA 回调函数 (msacm.h)
acmFormatEnumCallback 函数指定与 acmFormatEnum 函数一起使用的回调函数。 acmFormatEnumCallback 名称是应用程序定义的函数名称的占位符。
语法
ACMFORMATENUMCBA Acmformatenumcba;
BOOL Acmformatenumcba(
HACMDRIVERID hadid,
LPACMFORMATDETAILSA pafd,
DWORD_PTR dwInstance,
DWORD fdwSupport
)
{...}
参数
hadid
ACM 驱动程序标识符的句柄。
pafd
指向 ACMFORMATDETAILS 结构的指针，该结构包含格式标记的枚举格式详细信息。
dwInstance
在 acmFormatEnum 函数中指定的应用程序定义值。
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 以停止枚举。
注解
如果未枚举任何格式， 则 acmFormatEnum 函数将返回零MMSYSERR_NOERROR () 。 此外，不会调用回调函数。
不应从回调函数内部调用以下函数： acmDriverAdd、 acmDriverRemove 和 acmDriverPriority。
注意
msacm.h 标头将 ACMFORMATENUMCB 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | msacm.h |