次の方法で共有


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::GetProcAmpRangeIMFVideoProcessor::GetFilteringRange を呼び出して、さまざまな ProcAmp およびイメージ フィルター設定の値の範囲を見つけます。
  6. IMFVideoProcessor::SetProcAmpValuesIMFVideoProcessor::SetFilteringValue を呼び出して、ProcAmp とイメージ フィルターの設定を変更します。

要件

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

関連項目

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

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