IMFCaptureSource::RemoveEffect メソッド (mfcaptureengine.h)

キャプチャストリームから効果を削除します。

構文

HRESULT RemoveEffect(
  [in] DWORD    dwSourceStreamIndex,
  [in] IUnknown *pUnknown
);

[in] dwSourceStreamIndex

キャプチャストリーム。値には、次のいずれかを指定できます。

値	意味
0 ~ 0xFFFFFFFB	ストリームの 0 から始まるインデックス。ストリームの数を取得するには、 IMFCaptureSource::GetDeviceStreamCount を呼び出します。
MF_CAPTURE_ENGINE_FIRST_SOURCE_PHOTO_STREAM 0xFFFFFFFB	最初のイメージストリーム。
MF_CAPTURE_ENGINE_FIRST_SOURCE_VIDEO_STREAM 0xFFFFFFFC	最初のビデオストリーム。
MF_CAPTURE_ENGINE_FIRST_SOURCE_AUDIO_STREAM 0xFFFFFFFD	最初のオーディオストリーム。

[in] pUnknown

効果オブジェクトの IUnknown インターフェイスへのポインター。

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

リターンコード	説明
S_OK	正常終了しました。
MF_E_INVALIDREQUEST	無効な要求です。指定した効果が見つからなかった可能性があります。
MF_E_INVALIDSTREAMNUMBER	dwSourceStreamIndex パラメーターが無効です。

このメソッドは、 IMFCaptureSource::AddEffect メソッドを使用して以前に追加された効果を削除します。