IMFVideoProcessor インターフェイス (evr9.h)
拡張ビデオ レンダラー (EVR) でのビデオ処理を制御します。 このインターフェイスを介して制御される操作には、色調整 (ProcAmp)、ノイズ フィルター、詳細フィルターが含まれます。
このインターフェイスは、EVR ミキサーによって実装されます。 インターフェイスへのポインターを取得するには、 IMFGetService::GetService を呼び出します。 サービス識別子は GUID MR_VIDEO_MIXER_SERVICEです。 次のいずれかのオブジェクトに対して GetService を呼び出します。
- メディア セッション (トポロジに EVR のインスタンスが含まれている場合)。
- EVR メディア シンク。
- DirectShow 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 つ以上のビデオ プロセッサ モードが用意されています。 各モードには、独自の機能セットがあります。 使用可能なモードの一覧は、ビデオのメディアの種類によって異なる場合があります。
このインターフェイスを使用するには、次の手順を実行します。
- EVR 入力ストリームでメディアの種類を初期化します。 (メディア セッションを使用している場合は、トポロジが解決された後に発生します。メディア セッションが MESessionTopologyStatus イベントを送信するまで待機し、状態値が MF_TOPOSTATUS_READY。
- IMFVideoProcessor::GetAvailableVideoProcessorModes を呼び出して、使用可能なビデオ プロセッサ モードの一覧を取得します。
- IMFVideoProcessor::GetVideoProcessorCaps を呼び出して、各ビデオ プロセッサ モードの機能を見つけます。
- IMFVideoProcessor::SetVideoProcessorMode を呼び出して、モードを選択します。 この手順をスキップすると、ストリーミングの開始時に EVR によってビデオ プロセッサ モードが自動的に選択されます。 その場合は、再生が開始されるまで待ってから、手順 5 に進みます。
- IMFVideoProcessor::GetProcAmpRange と IMFVideoProcessor::GetFilteringRange を呼び出して、さまざまな ProcAmp およびイメージ フィルター設定の値の範囲を見つけます。
- IMFVideoProcessor::SetProcAmpValues と IMFVideoProcessor::SetFilteringValue を呼び出して、ProcAmp とイメージ フィルターの設定を変更します。
要件
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | evr9.h |