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