IOverlayNotify インターフェイス (strmif.h)

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]

インターフェイスは IOverlayNotify 、デコーダーなどのアップストリーム フィルターを提供し、レンダリング ウィンドウに対する変更の通知を提供します。 これには、パレットの変更、カラー キー、ウィンドウの位置、表示領域 (クリッピング) の変更の通知が含まれます。

ほとんどのソフトウェア ビデオ デコーダーを使用すると、ビデオ レンダラーは、レンダラーの入力ピンの IMemInputPin インターフェイスにメディア サンプルを渡すことによって、生成された圧縮解除されたイメージを描画できます。

ただし、一部のビデオ デコード フィルター (通常はハードウェア圧縮解除ボード) では、VGA コネクタを使用して画像自体の描画が処理されます。 これらのフィルターは IMemInputPin を使用する必要はありませんが、代わりにレンダラー入力ピンによって提供される IOverlay インターフェイスを使用できます。 このインターフェイスを介して、デコーダーは、ウィンドウの位置またはサイズが変更されたとき、またはカラー キーとパレットをインストールおよび変更するために、現在のシステム パレットが変更されたときに通知できます。

独自の描画を行うデコーダーは、 インターフェイスと IOverlayNotify2 インターフェイスをIOverlayNotify実装する必要があります。 レンダラーはこのインターフェイスを使用して、ウィンドウのサイズや位置が変化したり、システム パレットが変更されたり、別のカラー キーが使用されたりするたびにデコーダーに通知します。 デコーダーは、レンダラーの入力ピンで IOverlay::Advise メソッドを呼び出して、コールバックを設定する必要があります。 コールバックが確立されると、レンダラーは、適切なイベントが発生したときにデコーダーの IOverlayNotify メソッドを呼び出します。 コールバックをキャンセルするには、 IOverlay::Unadvise メソッドを使用します。

ビデオ レンダラーは、このインターフェイスでメソッドを呼び出す唯一のフィルターです。 これは、既定のビデオ レンダラーによって自動的に行われます。 代替ビデオ レンダラーを作成する場合は、フィルターで IOverlay がサポートされ、このインターフェイスが IOverlay::Advise 呼び出しでフィルターに渡される場合は、このインターフェイスで メソッドを使用する必要があります。

継承

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

メソッド

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

IOverlayNotify::OnClipChange OnClipChange メソッドは、ウィンドウの表示領域が変更されたことを通知します。 このメソッドから戻る前に、表示領域への変更を反映するようにオーバーレイ ハードウェアを更新することが不可欠です。
IOverlayNotify::OnColorKeyChange OnColorKeyChange メソッドは、ウィンドウの色キーが変更されたことを通知します。
IOverlayNotify::OnPaletteChange OnPaletteChange メソッドは、ウィンドウのパレットが変更されたことを通知します。
IOverlayNotify::OnPositionChange OnPositionChange メソッドは、位置が変更されたことを通知します。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	strmif.h (Dshow.h を含む)