IVideoWindow::put_FullScreenMode (Windows CE 5.0)

Send Feedback

This method sets the full-screen mode for the video renderer filter supporting this interface.

HRESULT put_FullScreenMode(longFullScreenMode);

Parameters

  • FullScreenMode
    [in] OATRUE if supporting full-screen video, or OAFALSE if not.

Return Values

Returns E_NOTIMPL if the video renderer does not support full-screen mode or NOERROR if it does.

Remarks

This method enables an application to switch a full-screen renderer into and out of full-screen mode. The renderer's behavior when switched out of full-screen mode is implementation-dependent. The Microsoft full-screen renderer, for example, switches back to a window.

The IVideoWindow plug-in distributor in the filter graph manager implements full-screen renderer switching. It looks to see if a renderer in the graph supports a full-screen mode. If not, it temporarily replaces the renderer with the default DirectShow full-screen renderer.

It calls IVideoWindow::GetMaxIdealImageSize to determine if a window can be made a topmost window and resized to the entire display. This is preferred to swapping renderers, because the filter graph might be using DirectDraw overlays or a hardware decoder filter.

Requirements

DirectShow applications and DirectShow filters have different include file and link library requirements.

For more information, see Setting Up the Build Environment.

Pocket PC: Windows Mobile 5.0 and later
Smartphone: Windows Mobile 5.0 and later
OS Versions: Windows CE 2.12 and later. Version 2.12 requires DXPAK 1.0 or later.

See Also

IVideoWindow Interface

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.