Share via

IDDrawExclModeVideo::SetCallbackInterface メソッド (strmif.h)

  • [アーティクル]

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

メソッドは SetCallbackInterface 、オーバーレイ ミキサーのコールバック インターフェイスへのポインターを取得して、呼び出し元のアプリケーションにビデオ再生中のディスプレイの調整について通知できるようにします。

構文

HRESULT SetCallbackInterface(
  [out] IDDrawExclModeVideoCallback *pCallback,
  [in]  DWORD                       dwFlags
);

パラメーター

[out] pCallback

IDDrawExclModeVideoCallback インターフェイスを実装するオブジェクトへのポインター。 pCallback が NULL の場合、コールバック インターフェイスは NULL に設定され、それ以上のコールバックは行われません。 以前のコールバック インターフェイスがあった場合は解放され、それ以上コールバックは行われません。 pCallback が NULL ではなく、このメソッドがS_OKを返す場合、pCallback が指すオブジェクトの参照カウントがインクリメントされます。

[in] dwFlags

ゼロを指定してください。

戻り値

HRESULT 値を返します。 使用可能な値は次のとおりです。

リターン コード 説明
S_OK
 正常終了しました。
E_INVALIDARG
 引数が無効です。

注釈

アプリケーションでは、このメソッドを使用して、オーバーレイ のサイズ、位置、または色のキーの変更に関する通知を受け取り、ビデオを非表示または表示したり、開始、終了、または再生中にビデオを調整したりできます。 このメソッドを呼び出すことで、アプリケーションは IDDrawExclModeVideoCallback インターフェイスにアクセスし、そのインターフェイスへのポインターをオーバーレイ ミキサーに渡すことができます。

要件

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

こちらもご覧ください

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

IDDrawExclModeVideo インターフェイス