Share via

acmFilterTagEnumW 函数 (msacm.h)

  • 项目

acmFilterTagEnum 函数枚举 ACM 驱动程序提供的波形音频筛选器标记。 此函数将继续枚举，直到没有更多合适的筛选器标记或回调函数返回 FALSE。

语法

MMRESULT ACMAPI acmFilterTagEnumW(
  HACMDRIVER             had,
  LPACMFILTERTAGDETAILSW paftd,
  ACMFILTERTAGENUMCBW    fnCallback,
  DWORD_PTR              dwInstance,
  DWORD                  fdwEnum
);

参数

had

ACM 驱动程序的句柄，用于查询波形音频筛选器标记详细信息。 如果此参数为 NULL，则 ACM 将使用第一个合适的 ACM 驱动程序中的详细信息。

paftd

指向 ACMFILTERTAGDETAILS 结构的指针，该结构在传递给 fnCallback 函数时包含筛选器标记详细信息。 当应用程序调用 acmFilterTagEnum 时，必须初始化此结构的 cbStruct 成员。

fnCallback

应用程序定义的回调函数的过程实例地址。

dwInstance

64 位 (DWORD_PTR) 或 32 位 (DWORD) 应用程序定义的值，该值连同 ACM 筛选器标记详细信息一起传递给回调函数。

fdwEnum

保留;必须为零。

返回值

如果成功，则返回零，否则返回错误。 可能的错误值包括以下内容。

返回代码 说明
MMSYSERR_INVALFLAG
 至少有一个标志无效。
MMSYSERR_INVALHANDLE
 指定的句柄无效。
MMSYSERR_INVALPARAM
 至少有一个参数无效。

注解

如果未安装合适的 ACM 驱动程序，此函数将返回零) MMSYSERR_NOERROR (。 此外，不会调用回调函数。

注意

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

要求

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

另请参阅

音频压缩函数

音频压缩管理器