IVideoWindow::put_FullScreenMode (Compact 2013)

  • Article

3/26/2014

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

Header

dshow.h

Library

Strmiids.lib

See Also

Reference

IVideoWindow Interface