IVideoWindow::put_MessageDrain
put_MessageDrain メソッドは、ビデオ ウィンドウからマウス メッセージとキーボードメッセージを受け取るウィンドウを指定する。
構文
HRESULT put_MessageDrain(
OAHWND Drain
);
パラメータ
Drain
[in] ウィンドウのハンドルを OAHWND 値として受け取る変数へのポインタ。
戻り値
次のいずれかの値を返す。
値 | 説明 |
S_OK | 成功。 |
VFW_E_NOT_CONNECTED | ビデオ レンダラ フィルタが接続されていない。 |
注意
このメソッドを利用すると、アプリケーションはビデオ ウィンドウ内で生成されたマウス イベントおよびキーボード イベントに応答できる。
Drain が NULL 以外の場合、ビデオ レンダラは PostMessage 関数を使って、特定のメッセージを指定されたウィンドウに転送する。どのメッセージが転送されるかは、使っているビデオ レンダラに依存する。ビデオ レンダラ フィルタおよび VMR (Video Mixing Renderer) フィルタは、以下のメッセージを転送する。
- WM_CHAR
- WM_DEADCHAR
- WM_KEYDOWN
- WM_KEYUP
- WM_LBUTTONDBLCLK
- WM_LBUTTONDOWN
- WM_LBUTTONUP
- WM_MBUTTONDBLCLK
- WM_MBUTTONDOWN
- WM_MBUTTONUP
- WM_MOUSEACTIVATE
- WM_MOUSEMOVE
- WM_NCLBUTTONDBLCLK
- WM_NCLBUTTONDOWN
- WM_NCLBUTTONUP
- WM_NCMBUTTONDBLCLK
- WM_NCMBUTTONDOWN
- WM_NCMBUTTONUP
- WM_NCMOUSEMOVE
- WM_NCRBUTTONDBLCLK
- WM_NCRBUTTONDOWN
- WM_NCRBUTTONUP
- WM_RBUTTONDBLCLK
- WM_RBUTTONDOWN
- WM_RBUTTONUP
- WM_SYSCHAR
- WM_SYSDEADCHAR
- WM_SYSKEYDOWN
- WM_SYSKEYUP
メッセージ ドレーン ウィンドウは、ビデオ ウィンドウの親ウィンドウになる必要はないので、フルスクリーン アプリケーションはこのメソッドを使える。
参照