通过

ACMFILTERENUMCBA 回调函数 （msacm.h）

  • 项目

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

语法

ACMFILTERENUMCBA Acmfilterenumcba;

BOOL Acmfilterenumcba(
  HACMDRIVERID hadid,
  LPACMFILTERDETAILSA pafd,
  DWORD_PTR dwInstance,
  DWORD fdwSupport
)
{...}

参数

hadid

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

pafd

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

dwInstance

acmFilterEnum中指定的应用程序定义值。

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 停止枚举。

言论

如果未枚举筛选器，acmFilterEnum 函数将返回MMSYSERR_NOERROR（零）。 此外，不会调用回调函数。

不应从回调函数中调用以下函数：acmDriverAdd、acmDriverRemove，acmDriverPriority。

注意

msacm.h 标头将 ACMFILTERENUMCB 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

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

另请参阅

音频压缩函数

音频压缩管理器