IVideoWindow::put_MessageDrain

Microsoft DirectX 8.1 (C++)

IVideoWindow::put_MessageDrain

The put_MessageDrain method specifies a window to receive mouse and keyboard messages from the video window.

Syntax

HRESULT put_MessageDrain(
  OAHWND Drain
);

Parameters

Drain

[in] Specifies a handle to the window, as an OAHWND value.

Return Values

Possible return values include the following:

Value	Description
S_OK	Success.
VFW_E_NOT_CONNECTED	The pins are not connected.

Remarks

If Drain is non-NULL, the video renderer passes the following messages to the specified window, using the PostMessage function:

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

This method enables an application to respond to mouse and keyboard events generated within the video window. The message drain window does not need to be a parent of the video window, so full-screen applications can use this method.

See Also