通过

IKsFormatSupport：：GetDevicePreferredFormat 方法 (devicetopology.h)

  • 项目

GetDevicePreferredFormat 方法获取连接的首选音频流格式。

语法

HRESULT GetDevicePreferredFormat(
  [out] PKSDATAFORMAT *ppKsFormat
);

参数

[out] ppKsFormat

指向指针变量的指针，方法在其中写入缓冲区的地址，该缓冲区包含首选格式的格式说明符。 说明符以 KSDATAFORMAT 结构开头，后跟其他格式信息。 方法为格式说明符分配存储。 当不再需要存储时，调用方负责通过调用 CoTaskMemFree 函数来释放存储。 如果方法失败， *ppKsFormat 为 NULL。 有关 KSDATAFORMAT、格式说明符和 CoTaskMemFree 的详细信息，请参阅 Windows DDK 文档。

返回值

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

返回代码 说明
E_POINTER
 指针 ppKsFormat 为 NULL。
E_OUTOFMEMORY
 内存不足。

要求

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

另请参阅

IKsFormatSupport 接口