IMFVideoProcessor インターフェイス (evr9.h)

拡張ビデオ レンダラー (EVR) でのビデオ処理を制御します。 このインターフェイスを介して制御される操作には、色調整 (ProcAmp)、ノイズ フィルター、詳細フィルターが含まれます。

このインターフェイスは、EVR ミキサーによって実装されます。 インターフェイスへのポインターを取得するには、 IMFGetService::GetService を呼び出します。 サービス識別子は GUID MR_VIDEO_MIXER_SERVICEです。 次のいずれかのオブジェクトに対して GetService を呼び出します。

• メディア セッション (トポロジに EVR のインスタンスが含まれている場合)。
• EVR メディア シンク。
• DirectShow EVR フィルター。
• EVR ミキサー。

EVR 用のカスタム ミキサーを実装する場合は、必要に応じて、このインターフェイスをサービスとして公開できます。

継承

IMFVideoProcessor インターフェイスは、IUnknown インターフェイスから継承されます。 IMFVideoProcessor には、次の種類のメンバーもあります。

メソッド

IMFVideoProcessor インターフェイスには、これらのメソッドがあります。

IMFVideoProcessor::GetAvailableVideoProcessorModes ビデオ ドライバーがサポートするビデオ プロセッサ モードを取得します。
IMFVideoProcessor::GetBackgroundColor コンポジション四角形の背景色を取得します。 背景色は、ビデオ画像のレターボックス化に使用されます。
IMFVideoProcessor::GetFilteringRange 指定したイメージ フィルター設定の値の範囲を取得します。
IMFVideoProcessor::GetFilteringValue イメージ フィルターの現在の設定を取得します。
IMFVideoProcessor::GetProcAmpRange 色調整 (ProcAmp) 設定の値の範囲を取得します。
IMFVideoProcessor::GetProcAmpValues 1 つ以上の色調整 (ProcAmp) 設定の現在の設定を取得します。
IMFVideoProcessor::GetVideoProcessorCaps ビデオ プロセッサ モードの機能を取得します。
IMFVideoProcessor::GetVideoProcessorMode アプリケーションの優先ビデオ プロセッサ モードを取得します。 優先モードを設定するには、IMFVideoProcessor::SetVideoProcessorMode を呼び出します。
IMFVideoProcessor::SetBackgroundColor コンポジション四角形の背景色を設定します。 背景色は、ビデオ画像のレターボックス化に使用されます。
IMFVideoProcessor::SetFilteringValue イメージ フィルターのパラメーターを設定します。
IMFVideoProcessor::SetProcAmpValues 1 つ以上の色調整 (ProcAmp) 設定を設定します。
IMFVideoProcessor::SetVideoProcessorMode 優先ビデオ プロセッサ モードを設定します。 EVR は、再生の開始時にこのモードの使用を試みます。

解説

このインターフェイスは、グラフィックス ドライバーによって実装される機能へのアクセスを提供します。 ドライバーには、GUID で識別される 1 つ以上のビデオ プロセッサ モードが用意されています。 各モードには、独自の機能セットがあります。 使用可能なモードの一覧は、ビデオのメディアの種類によって異なる場合があります。

このインターフェイスを使用するには、次の手順を実行します。

1. EVR 入力ストリームでメディアの種類を初期化します。 (メディア セッションを使用している場合は、トポロジが解決された後に発生します。メディア セッションが MESessionTopologyStatus イベントを送信するまで待機し、状態値が MF_TOPOSTATUS_READY。
2. IMFVideoProcessor::GetAvailableVideoProcessorModes を呼び出して、使用可能なビデオ プロセッサ モードの一覧を取得します。
3. IMFVideoProcessor::GetVideoProcessorCaps を呼び出して、各ビデオ プロセッサ モードの機能を見つけます。
4. IMFVideoProcessor::SetVideoProcessorMode を呼び出して、モードを選択します。 この手順をスキップすると、ストリーミングの開始時に EVR によってビデオ プロセッサ モードが自動的に選択されます。 その場合は、再生が開始されるまで待ってから、手順 5 に進みます。
5. IMFVideoProcessor::GetProcAmpRange と IMFVideoProcessor::GetFilteringRange を呼び出して、さまざまな ProcAmp およびイメージ フィルター設定の値の範囲を見つけます。
6. IMFVideoProcessor::SetProcAmpValues と IMFVideoProcessor::SetFilteringValue を呼び出して、ProcAmp とイメージ フィルターの設定を変更します。

要件

サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	evr9.h

関連項目

強化されたビデオ レンダラー

メディア ファンデーション インターフェイス