IMFMediaEngineEx：：InsertAudioEffect 方法 (mfmediaengine.h)

插入音訊效果。

語法

HRESULT InsertAudioEffect(
  [in] IUnknown *pEffect,
  [in] BOOL     fOptional
);

參數

[in] pEffect

下列其中之一：

• 媒體基礎轉換 (MFT) 實作音訊效果的 IMFTransform 介面指標。
• 啟用物件的 IMFActivate 介面指標。 啟用對象必須建立音訊效果的 MFT。

[in] fOptional

指定效果是否為選擇性。

值	意義
真	效果是選擇性的。 如果媒體引擎無法新增效果，它會忽略效果並繼續播放。
假	需要效果。 如果 Media Engine 物件無法新增效果，就會發生播放錯誤。

傳回值

這個方法可以傳回下列其中一個值。

傳回碼	描述
S_OK	成功。
MF_E_INVALIDREQUEST	達到音訊效果的最大數目。

備註

載入下一個媒體資源時，會套用效果。

規格需求

需求	值
最低支援的用戶端	Windows 8 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2012 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	mfmediaengine.h

另請參閱

IMFMediaEngineEx