IFullScreenVideoEx::GetMessageDrain
| Microsoft DirectShow 9.0 |
IFullScreenVideoEx::GetMessageDrain
The GetMessageDrain method retrieves the window that receives mouse and keyboard messages, if any.
Syntax
HRESULT GetMessageDrain( HWND *hwnd );
Parameters
hwnd
[out] Pointer to a variable that receives the handle of the window. If no window has been designated to receive messages, this parameter receives the value NULL.
Return Values
Returns an HRESULT value. Possible values include the following.
| Value | Description |
| E_POINTER | NULL pointer argument. |
| S_OK | Success. |
Remarks
This method is equivalent to the IVideoWindow::get_MessageDrain method.
The Full Screen video renderer posts all mouse and keyboard messages to the window designated as a message drain. The exact list of messages that are posted is the same as the list given in IVideoWindow::put_MessageDrain.
Applications do not need to use this method. Use the IVideoWindow::get_MessageDrain method on the Filter Graph Manager instead.
Requirements
Header: Declared in Amvideo.h; include Dshow.h.
Library: Use Strmiids.lib.
See Also