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
可用于目标格式的大小(以字节为单位)。 acmMetrics 和 acmFormatTagDetails 函数可用于确定指定驱动程序 (或所有已安装的 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 匹配或失败的目标格式。 |
返回值
如果成功,则返回零,否则返回错误。 可能的错误值包括以下内容。
返回代码 | 说明 |
---|---|
|
至少有一个标志无效。 |
|
指定的句柄无效。 |
|
至少有一个参数无效。 |
要求
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | msacm.h |
Library | Msacm32.lib |
DLL | Msacm32.dll |