通过

acmFormatTagDetailsA 函数 （msacm.h）

  • 项目

acmFormatTagDetails 函数查询 ACM，以获取有关特定波形音频格式标记的详细信息。

语法

MMRESULT ACMAPI acmFormatTagDetailsA(
  HACMDRIVER             had,
  LPACMFORMATTAGDETAILSA paftd,
  DWORD                  fdwDetails
);

参数

had

用于查询波形音频格式标记详细信息的 ACM 驱动程序的句柄。 如果此参数 NULL，ACM 将使用第一个合适的 ACM 驱动程序中的详细信息。 使用ACM_FORMATTAGDETAILSF_INDEX查询类型时，应用程序必须指定有效的句柄或驱动程序标识符。 不允许禁用驱动程序的驱动程序标识符。

paftd

指向 ACMFORMATTAGDETAILS 结构的指针，该结构用于接收格式标记详细信息。

fdwDetails

用于获取详细信息的标志。 定义了以下值。

[ACMFORMATTAGDETAILS]（./nf-msacm-acmformattagdetails.md） 结构。 格式标记详细信息将在 paftd指向的结构中返回。 如果应用程序为 指定 ACM 驱动程序句柄，则会为该驱动程序返回有关格式标记的详细信息。 如果应用程序为 指定 NULL，则 ACM 将找到返回详细信息的第一个可接受的驱动程序。 [ACMDRIVERDETAILS]ACM 驱动程序的 （./nf-msacm-acmdriverdetails.md） 结构。 使用此标志检索格式标记详细信息时，应用程序必须指定 的驱动程序句柄。 [ACMFORMATTAGDETAILS]（./nf-msacm-acmformattagdetails.md） 结构必须WAVE_FORMAT_UNKNOWN或格式标记才能查找其最大大小。 如果应用程序指定 的 ACM 驱动程序句柄，则会为该驱动程序返回有关最大格式标记的详细信息。 如果应用程序 为 指定了 NULL，则 ACM 将找到请求返回详细信息的最大格式标记的可接受驱动程序。
价值 意义
ACM_FORMATTAGDETAILSF_FORMATTAG
ACM_FORMATTAGDETAILSF_INDEX
ACM_FORMATTAGDETAILSF_LARGESTSIZE

返回值

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

返回代码 描述
ACMERR_NOTPOSSIBLE
 请求的详细信息不可用。
MMSYSERR_INVALFLAG
 至少有一个标志无效。
MMSYSERR_INVALHANDLE
 指定的句柄无效。
MMSYSERR_INVALPARAM
 至少有一个参数无效。

言论

注意

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

要求

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

另请参阅

音频压缩函数

音频压缩管理器