acmFormatSuggest 函数 (msacm.h)

acmFormatSuggest 函数查询 ACM 或指定的 ACM 驱动程序,以建议提供源格式的目标格式。 例如,应用程序可以使用此函数来确定压缩格式可以解压缩到的一个或多个有效的 PCM 格式。

语法

MMRESULT ACMAPI acmFormatSuggest(
  HACMDRIVER     had,
  LPWAVEFORMATEX pwfxSrc,
  LPWAVEFORMATEX pwfxDst,
  DWORD          cbwfxDst,
  DWORD          fdwSuggest
);

parameters

had

要查询建议的目标格式的驱动程序的打开实例的句柄。 如果此参数为 NULL,则 ACM 会尝试查找建议目标格式的最佳驱动程序。

pwfxSrc

指向 WAVEFORMATEX 结构的指针,该结构标识 ACM 或指定驱动程序将为其建议目标格式的源格式。

pwfxDst

指向将接收 pwfxSrc 格式的建议目标格式的 WAVEFORMATEX 结构的指针。 根据 fdwSuggest 参数, pwfxDst 指向的结构的某些成员可能需要初始化。

cbwfxDst

可用于目标格式的大小(以字节为单位)。 acmMetricsacmFormatTagDetails 函数可用于确定指定驱动程序 (或所有已安装的 ACM 驱动程序) 所需的最大大小。

fdwSuggest

用于匹配所需目标格式的标志。 定义了以下值。

含义
ACM_FORMATSUGGESTF_NCHANNELS pwfxDst 指向的结构的 nChannels 成员有效。 ACM 将查询可接受的已安装驱动程序,这些驱动程序可以建议与 nChannels 匹配或失败的目标格式。
ACM_FORMATSUGGESTF_NSAMPLESPERSEC pwfxDst 指向的结构的 nSamplesPerSec 成员有效。 ACM 将查询可接受的已安装驱动程序,这些驱动程序可以建议与 nSamplesPerSec 匹配或失败的目标格式。
ACM_FORMATSUGGESTF_WBITSPERSAMPLE pwfxDst 指向的结构的 wBitsPerSample 成员有效。 ACM 将查询可接受的已安装驱动程序,这些驱动程序可以建议与 wBitsPerSample 匹配或失败的目标格式。
ACM_FORMATSUGGESTF_WFORMATTAG pwfxDst 指向的结构的 wFormatTag 成员有效。 ACM 将查询可接受的已安装驱动程序,这些驱动程序可以建议与 wFormatTag 匹配或失败的目标格式。

返回值

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

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

要求

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

另请参阅

音频压缩函数

音频压缩管理器