共用方式為

IKsFormatSupport：：GetDevicePreferredFormat 方法 (devicetopology.h)

  • 發行項

GetDevicePreferredFormat 方法會取得連接的慣用音訊數據流格式。

語法

HRESULT GetDevicePreferredFormat(
  [out] PKSDATAFORMAT *ppKsFormat
);

參數

[out] ppKsFormat

指標變數的指標，方法會寫入緩衝區的位址，其中包含慣用格式的格式規範。 規範的開頭是 KSDATAFORMAT 結構，後面可能接著其他格式資訊。 方法會配置格式規範的記憶體。 呼叫端會藉由呼叫 CoTaskMemFree 函式，負責釋出不再需要的記憶體。 如果方法失敗， *ppKsFormat 為 NULL。 如需 KSDATAFORMAT、格式規範和 CoTaskMemFree 的詳細資訊，請參閱 Windows DDK 檔。

傳回值

如果方法成功，它會傳回 S_OK。 如果失敗，可能的傳回碼包括，但不限於下表所示的值。

傳回碼 Description
E_POINTER
 指標 ppKsFormat 為 NULL。
E_OUTOFMEMORY
 記憶體不足。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 devicetopology.h

另請參閱

IKsFormatSupport 介面