Microsoft DirectX 8.1 (C++)

IFullScreenVideo::GetMessageDrain

The GetMessageDrain method retrieves the window set to receive window messages sent to the renderer.

Syntax

HRESULT GetMessageDrain(
  HWND *hwnd
);

Parameters

hwnd

[out] Pointer to the window handle of the window specified as the message drain.

Return Value

Returns an HRESULT value.

Remarks

The full-screen video renderer posts all mouse and keyboard messages it receives to the window designated as a message drain, with the message parameters untranslated. The exact list of messages passed is the same as for IVideoWindow::put_MessageDrain. An application can use this to implement hot-key support for full-screen video. For example, it might watch for the CTRL+P key combination as a cue to pause the video.

See Also