IVideoWindow::put_FullScreenMode

Microsoft DirectX 8.1 (C++)

The put_FullScreenMode method enables or disabled full-screen mode.

Syntax

HRESULT put_FullScreenMode(
    long FullScreenMode
);

Parameters

FullScreenMode

[in] Value that specifies whether to enable or disable full-screen mode. Must be one of the following values:

Value	Description
OATRUE	Enable full-screen mode.
OAFALSE	Disable full-screen mode. (Default.)

Return Values

Possible return values include the following:

Value	Description
E_NOTIMPL	Filter does not support full-screen mode.
S_FALSE	Filter is already in the requested mode.
S_OK	Success.

Remarks

Video renderers should switch to the requested mode, or return E_NOTIMPL.

The Filter Graph Manager tries the following, in order of preference:

Use the current video renderer, if it supports full-screen mode.
Stretch the existing window to cover the entire display, if this can be done without a performance penalty. (The Filter Graph Manager calls IVideoWindow::GetMaxIdealImageSize to determine this.)
Switch to the Full Screen Renderer Filter.
Stretch the existing window to cover the entire display, despite any performance penalty.

See Also