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
 指针 pKsFormat 或 pbSupported 为 NULL。
E_INVALIDARG
 格式说明符无效。

要求

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

另请参阅

IKsFormatSupport 接口