Microsoft DirectX 8.1 (C++)

IFullScreenVideo::SetMessageDrain

The SetMessageDrain method specifies a window that will receive window messages sent to the renderer.

Syntax

HRESULT SetMessageDrain(
  HWND hwnd
);

Parameters

hwnd

[in] Window handle of the message drain window.

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