IAudioProcessingObject：：IsOutputFormatSupported 方法 (audioenginebaseapo.h)

  • 發行項

方法 IsOutputFormatSupported 可用來確認支援特定的輸出格式。

語法

HRESULT IsOutputFormatSupported(
  [in, optional]  IAudioMediaType *pOppositeFormat,
  [in, optional]  IAudioMediaType *pRequestedOutputFormat,
  [out, optional] IAudioMediaType **ppSupportedOutputFormat
);

參數

[in, optional] pOppositeFormat

IAudioMediaType 介面的指標。 此參數表示輸出格式。 此參數必須設定為 NULL ，以指出輸出格式可以是任何類型的。

[in, optional] pRequestedOutputFormat

IAudioMediaType 介面的指標。 此參數表示要驗證的輸出格式。

[out, optional] ppSupportedOutputFormat

此參數指出最接近要驗證之格式的支持輸出格式。

傳回值

如果呼叫順利完成，ppSupportedOutputFormat 參數會傳回 pRequestedOutputFormat 指標，而 IsOutputFormatSupported 方法會傳回 S_OK 的值。 否則，此方法會傳回下列其中一個錯誤碼：

傳回碼 Description
S_FALSE
 不支援輸入/輸出格式組的格式。 ppSupportedOutPutFormat 參數會傳回建議的新格式。
APOERR_FORMAT_NOT_SUPPORTED
 不支援格式。 ppSupportedOutputFormat 的值不會變更。
E_POINTER
 傳遞至函式的指標無效。 ppSupportedOutputFormat 的值不會變更。
其他 HRESULT 值
 音訊引擎會追蹤這些額外的錯誤狀況。

備註

不同 API 實作 IsOutputFormatSupported 方法的差異。 例如，使用特定實作時，只有在輸入格式為整數類型時，輸出才能是 float 類型。

規格需求

需求 值
最低支援的用戶端 適用於 Windows Vista 和更新版本的 Windows 作業系統。
目標平台 Universal
標頭 audioenginebaseapo.h
程式庫 Audioenginebaseapo.idl
IRQL 所有層級

另請參閱

IAudioMediaType

IAudioProcessingObject