acmFormatTagEnum 函数 (msacm.h)

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

语法

MMRESULT ACMAPI acmFormatTagEnum(
  HACMDRIVER            had,
  LPACMFORMATTAGDETAILS paftd,
  ACMFORMATTAGENUMCB    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 () 。 此外,不会调用回调函数。

要求

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

另请参阅

音频压缩函数

音频压缩管理器