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 |
---|---|
|
傳遞至函式的指標無效 |
|
無法配置傳回緩衝區 |
|
nFormat 超出範圍 |
備註
當音訊系統呼叫 GetFormat
方法時,sAPO 會建立音訊媒體類型物件,並傳回 IAudioMediaType 介面。 sAPO 實作可以使用 CreateAudioMediaType 公用程式函式來建立音訊媒體類型物件。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 可在 Windows Vista 和更新版本的 Windows 中使用。 |
目標平台 | 桌面 |
標頭 | audioenginebaseapo.h (include Audioenginebaseapo.h) |
IRQL | 所有層級。 |