acmFormatTagDetails 函数 (msacm.h)

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

语法

MMRESULT ACMAPI acmFormatTagDetails(
  HACMDRIVER            had,
  LPACMFORMATTAGDETAILS paftd,
  DWORD                 fdwDetails
);

参数

had

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

paftd

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

fdwDetails

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

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

值	含义
ACM_FORMATTAGDETAILSF_FORMATTAG
ACM_FORMATTAGDETAILSF_INDEX
ACM_FORMATTAGDETAILSF_LARGESTSIZE

返回值

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

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

要求

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

另请参阅

音频压缩函数

音频压缩管理器