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 を含む) |