acmFormatDetailsW 函数 (msacm.h)

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

语法

MMRESULT ACMAPI acmFormatDetailsW(
  HACMDRIVER          had,
  LPACMFORMATDETAILSW pafd,
  DWORD               fdwDetails
);

参数

had

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

pafd

指向 ACMFORMATDETAILS 结构的指针,该结构包含给定格式标记的格式详细信息。

fdwDetails

用于获取波形音频格式标记详细信息的标志。 定义了以下值。

[ACMFORMATDETAILS] (./nf-msacm-acmformatdetails.md) 结构,应返回剩余的详细信息。 ACMFORMATDETAILS 结构的 dwFormatTag 成员必须初始化为 pwfx 指定的相同格式标记。 此查询类型可用于获取任意格式结构的字符串说明。 如果应用程序为 had 指定了 ACM 驱动程序句柄,则将为该驱动程序返回有关格式的详细信息。 如果应用程序为 had 指定 NULL,则 ACM 会查找第一个可接受的驱动程序来返回详细信息。
含义
ACM_FORMATDETAILSF_FORMAT
ACM_FORMATDETAILSF_INDEX ACMFORMATDETAILS 结构的 dwFormatIndex 成员中提供了格式标记的格式索引。 格式详细信息将在 pafd 定义的 结构中返回。 索引范围为 0 到 1,比格式标记的 ACMFORMATTAGDETAILS 结构中返回的 cStandardFormats 成员少一个。 使用此标志检索格式详细信息时,应用程序必须为 had 指定驱动程序句柄。 有关在调用此函数之前应初始化哪些成员的信息,请参阅 ACMFORMATDETAILS 结构。

返回值

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

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

注解

注意

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

要求

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

另请参阅

音频压缩函数

音频压缩管理器