通过

acmFormatTagEnumA 函数 （msacm.h）

  • 项目

acmFormatTagEnum 函数枚举 ACM 驱动程序提供的波形音频格式标记。 此函数继续枚举，直到没有更合适的格式标记或回调函数返回 FALSE。

语法

MMRESULT ACMAPI acmFormatTagEnumA(
  HACMDRIVER             had,
  LPACMFORMATTAGDETAILSA paftd,
  ACMFORMATTAGENUMCBA    fnCallback,
  DWORD_PTR              dwInstance,
  DWORD                  fdwEnum
);

参数

had

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

paftd

指向 ACMFORMATTAGDETAILS 结构的指针，该结构接收传递给 fnCallback中指定的函数的格式标记详细信息。 此结构必须初始化 ACMFORMATTAGDETAILS 结构的 cbStruct 成员。

fnCallback

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

dwInstance

传递给回调函数的 64 位（DWORD_PTR）或 32 位（DWORD）应用程序定义值以及 ACM 格式标记详细信息。

fdwEnum

保留;必须为零。

返回值

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

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

言论

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

注意

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

要求

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

另请参阅

音频压缩函数

音频压缩管理器