CXAPOBase::ValidateFormatPair 方法 (xapobase.h)

验证 XAPO 是否支持输入和输出格式对配置。

语法

HRESULT ValidateFormatPair(
  const WAVEFORMATEX *pSupportedFormat,
  WAVEFORMATEX       *pRequestedFormat,
  BOOL               fOverwrite
);

参数

pSupportedFormat

已知受 XAPO 支持的音频格式。

pRequestedFormat

要检查的音频格式必须是指向 WAVEFORMATEXTENSIBLE 结构的指针(如果 fOverWrite 为 TRUE)。

fOverwrite

如果 TRUE 指示 pRequestedFormat 在不支持请求的格式不受支持时,应使用支持的最接近的音频格式进行覆盖。 最接近的音频格式由位深度、帧速率和声道计数按重要性顺序确定。

返回值

如果支持格式对,则返回S_OK。 如果格式对不受支持,则返回XAPO_E_FORMAT_UNSUPPORTED;如果 fOverWrite 为 TRUE,将覆盖 pRequestedFormat。 如果任一音频格式无效,则返回E_INVALIDARG; pRequestedFormat 将保持不变。

注解

平台要求

Windows 10 (XAudio2.9) ;Windows 8,Windows Phone 8 (XAudio 2.8) ;DirectX SDK (XAudio 2.7)

要求

要求
目标平台 Windows
标头 xapobase.h
Library XAPOBase.lib

另请参阅

CXAPOBase