IKsFormatSupport::IsFormatSupported 方法 (devicetopology.h)

IsFormatSupported 方法指示音频终结点设备是否支持指定的音频流格式。

语法

HRESULT IsFormatSupported(
  [in]  PKSDATAFORMAT pKsFormat,
  [in]  DWORD         cbFormat,
  [out] BOOL          *pbSupported
);

参数

[in] pKsFormat

指向音频流格式说明符的指针。 此参数指向调用方分配的缓冲区,该缓冲区包含格式说明符。 说明符以 KSDATAFORMAT 结构开头,后跟其他格式信息。 有关 KSDATAFORMAT 和格式说明符的详细信息,请参阅 Windows DDK 文档。

[in] cbFormat

包含格式说明符的缓冲区的大小(以字节为单位)。

[out] pbSupported

指向 BOOL 变量的指针,方法在该变量中写入一个值以指示格式是否受支持。 如果设备支持格式,则方法写入 TRUE ;如果设备不支持格式,则写入 FALSE

返回值

如果该方法成功,则它会返回 S_OK。 如果失败,可能的返回代码包括但不限于下表中显示的值。

返回代码 说明
E_POINTER
指针 pKsFormatpbSupportedNULL
E_INVALIDARG
格式说明符无效。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 devicetopology.h

另请参阅

IKsFormatSupport 接口