IMFCaptureSource::AddEffect メソッド (mfcaptureengine.h)
キャプチャ ストリームに効果を追加します。
構文
HRESULT AddEffect(
[in] DWORD dwSourceStreamIndex,
[in] IUnknown *pUnknown
);
パラメーター
[in] dwSourceStreamIndex
キャプチャ ストリーム。 値には、次のいずれかを指定できます。
| 値 | 意味 |
|---|---|
|
ストリームの 0 から始まるインデックス。 ストリームの数を取得するには、 IMFCaptureSource::GetDeviceStreamCount を呼び出します。 |
|
最初のイメージ ストリーム。 |
|
最初のビデオ ストリーム。 |
|
最初のオーディオ ストリーム。 |
[in] pUnknown
次のいずれかを指すポインター。
- IMFTransform インターフェイスを公開する Media Foundation 変換 (MFT)。
- IMFActivate インターフェイスを公開する MFT アクティブ化オブジェクト。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
| リターン コード | 説明 |
|---|---|
|
正常終了しました。 |
|
互換性のあるメディアの種類が見つかりませんでした。 |
|
dwSourceStreamIndex パラメーターが無効です。 |
注釈
効果は 、Media Foundation Transform (MFT) として実装する必要があります。 pUnknown パラメーターは、MFT のインスタンス、または MFT のアクティブ化オブジェクトを指すことができます。 詳細については、「 アクティブ化オブジェクト」を参照してください。
この効果は、データがキャプチャ シンクに到達する前にストリームに適用されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | mfcaptureengine.h |