IVideoWindow::put_FullScreenMode
A version of this page is also available for
4/8/2010
This method sets the full-screen mode for the video renderer filter supporting this interface.
Syntax
HRESULT put_FullScreenMode(
long FullScreenMode
);
Parameters
- FullScreenMode
[in] OATRUE if supporting full-screen video, or OAFALSE if not.
Return Value
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
| Windows Embedded CE | Windows CE 2.12 and later |
| Windows Mobile | Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later |
| Note | Microsoft DirectShow applications and DirectShow filters have different include file and Library requirements For more information, see Setting Up the Build Environment, Version 2.12 requires DXPAK 1.0 or later |