ACMFILTERTAGENUMCB 回调函数 (msacm.h)

acmFilterTagEnumCallback 函数指定与 acmFilterTagEnum 函数一起使用的回调函数。 acmFilterTagEnumCallback 函数名称是应用程序定义的函数名称的占位符。

语法

ACMFILTERTAGENUMCB Acmfiltertagenumcb;

BOOL Acmfiltertagenumcb(
  HACMDRIVERID hadid,
  LPACMFILTERTAGDETAILS paftd,
  DWORD_PTR dwInstance,
  DWORD fdwSupport
)
{...}

参数

hadid

ACM 驱动程序标识符的句柄。

paftd

指向包含枚举筛选器标记详细信息的 ACMFILTERTAGDETAILS 结构的指针。

dwInstance

在 acmFilterTagEnum 中指定的应用程序定义值。

fdwSupport

特定于驱动程序标识符 ACMDRIVERDETAILS 结构的驱动程序支持标志。 此参数可以是以下值的组合,并标识驱动程序支持哪些操作与筛选器标记。

Value 含义
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_INPUTACM_METRIC_HARDWARE_WAVE_OUTPUT 指标索引配合使用,以获取与支持 ACM 驱动程序关联的波形音频设备标识符。

返回值

回调函数必须返回 TRUE 才能继续枚举或 FALSE 以停止枚举。

注解

如果未枚举筛选器标记, acmFilterTagEnum 函数将返回 MMSYSERR_NOERROR (零) 。 此外,不会调用回调函数。

不应在回调函数中调用以下函数: acmDriverAddacmDriverRemoveacmDriverPriority

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 msacm.h

另请参阅

音频压缩函数

音频压缩管理器