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

キャプチャストリームに効果を追加します。

構文

HRESULT AddEffect(
  [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

次のいずれかを指すポインター。

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

リターンコード	説明
S_OK	正常終了しました。
MF_E_INVALIDMEDIATYPE	互換性のあるメディアの種類が見つかりませんでした。
MF_E_INVALIDSTREAMNUMBER	dwSourceStreamIndex パラメーターが無効です。

効果は、Media Foundation Transform (MFT) として実装する必要があります。 pUnknown パラメーターは、MFT のインスタンス、または MFT のアクティブ化オブジェクトを指すことができます。詳細については、「アクティブ化オブジェクト」を参照してください。

この効果は、データがキャプチャシンクに到達する前にストリームに適用されます。