IMFMediaEngineEx::InsertAudioEffect メソッド (mfmediaengine.h)

オーディオ効果を挿入します。

構文

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

[in] pEffect

次のいずれか:

オーディオ効果を実装する Media Foundation 変換 (MFT) の IMFTransform インターフェイスへのポインター。
アクティブ化オブジェクトの IMFActivate インターフェイスへのポインター。アクティブ化オブジェクトは、オーディオ効果の MFT を作成する必要があります。

[in] fOptional

効果が省略可能かどうかを指定します。

値	意味
True	効果は省略可能です。メディアエンジンで効果を追加できない場合、その効果は無視され、再生が続行されます。
False	効果が必要です。メディアエンジンオブジェクトが効果を追加できない場合は、再生エラーが発生します。

このメソッドは、これらの値のいずれかを返すことができます。

リターンコード	説明
S_OK	正常終了しました。
MF_E_INVALIDREQUEST	オーディオ効果の最大数に達しました。

この効果は、次のメディアリソースが読み込まれるときに適用されます。

要件	値
サポートされている最小のクライアント	Windows 8 [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows Server 2012 [デスクトップアプリ \|UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	mfmediaengine.h