共用方式為


IAudioSystemEffectsCustomFormats::GetFormat 方法 (audioenginebaseapo.h)

方法 GetFormat 會擷取自定義格式的 IAudioMediaType 表示法。

語法

HRESULT GetFormat(
  [in]            UINT            nFormat,
  [out, optional] IAudioMediaType **ppFormat
);

參數

[in] nFormat

指定支援之格式的索引。 此參數可以是範圍從零到一個小於 GetFormatCount 傳回值的任何值。 換句話說,範圍中的任何值從零到 GetFormatCount ( ) - 1。

[out, optional] ppFormat

指定 IAudioMediaType 介面指標的指標。 呼叫端必須負責釋放 ppFormat 參數所指向的 IAudioMediaType 介面。

傳回值

方法 GetFormat 會在呼叫成功時傳回S_OK。 否則,它會傳回下表所示的其中一個錯誤碼。

傳回碼 Description
E_POINTER
傳遞至函式的指標無效
E_OUTOFMEMORY
無法配置傳回緩衝區
E_INVALIDARG
nFormat 超出範圍

備註

當音訊系統呼叫 GetFormat 方法時,sAPO 會建立音訊媒體類型物件,並傳回 IAudioMediaType 介面。 sAPO 實作可以使用 CreateAudioMediaType 公用程式函式來建立音訊媒體類型物件。

規格需求

需求
最低支援的用戶端 可在 Windows Vista 和更新版本的 Windows 中使用。
目標平台 桌面
標頭 audioenginebaseapo.h (include Audioenginebaseapo.h)
IRQL 所有層級。

另請參閱

CreateAudioMediaType

GetFormatCount

IAudioMediaType