共用方式為

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