Share via

IOverlay::Advise メソッド (strmif.h)

  • [アーティクル]

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

メソッドはAdvise、dwInterests パラメーターで指定されたオーバーレイ イベントのアドバイズ リンクを設定します。

構文

HRESULT Advise(
  [in] IOverlayNotify *pOverlayNotify,
  [in] DWORD          dwInterests
);

パラメーター

[in] pOverlayNotify

通知インターフェイスへのポインター。

[in] dwInterests

目的のコールバック。次のイベントの任意のサブセットを指定できます。

Event 説明
ADVISE_NONE 変更はありません。
ADVISE_CLIPPING クリッピング領域の変更 (ウィンドウと同期)。
ADVISE_PALETTE パレットを変更します。
ADVISE_COLORKEY 彩度キー値の変化。
ADVISE_POSITION ビデオ ウィンドウの位置を変更します (ウィンドウと同期されません)。
ADVISE_DISPLAY_CHANGE WM_DISPLAYCHANGEで呼び出 されます。 WM_DISPLAYCHANGEメッセージは、表示解像度が変更されたときにすべてのウィンドウに送信されます。
ADVISE_ALL2 上記のすべて。

戻り値

成功した場合はS_OKを返します。 メソッドが失敗した場合は、 HRESULT エラー コードが返されます。

注釈

このメソッドは、 IOverlayNotify インターフェイスが通知を受信するためのアドバイス リンクを設定します。 これらのイベントのいずれかが発生した場合、渡された pOverlayNotify パラメーターの適切なエントリ ポイントが呼び出されます (IOverlayNotify::OnClipChange、 IOverlayNotify::OnColorKeyChange、 IOverlayNotify::OnPaletteChange、または IOverlayNotify::OnPositionChange)。

任意の IOverlay インターフェイスに設定できるアドバイズ リンクは 1 つだけです。 2 回目以降の呼び出しで別の通知インターフェイスを設定しようとすると、VFW_E_ADVISE_ALREADY_SETが返されます。 IOverlay::Unadvise を使用して、アドバイス リンクを取り消すことができます。

要件

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

こちらもご覧ください

エラーコードと成功コード

IOverlay インターフェイス