Freigeben über


IMFVideoDisplayControl::SetFullscreen Method

[This API is not supported and may be altered or unavailable in the future. ]

Sets or unsets full-screen rendering mode.

To implement full-screen playback, an application should simply resize the video window to cover the entire area of the monitor. Also set the window to be a topmost window, so that the application receives all mouse-click messages. For more information about topmost windows, see the documentation for the SetWindowPos function.

Syntax

HRESULT SetFullscreen(
  [in]  BOOL fFullscreen
);

Parameter

  • fFullscreen [in]
    If TRUE, the enhanced video renderer (EVR) uses full-screen mode. If FALSE, the EVR draws the video in the application-provided clipping window.

Rückgabewert

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Rückgabecode Beschreibung
S_OK

The method succeeded.

MF_E_SHUTDOWN

The video renderer has been shut down.

 

Hinweise

The default EVR presenter implements full-screen mode using Direct3D exclusive mode.

If you use this method to switch to full-screen mode, set the application window to be a topmost window and resize the window to cover the entire monitor. This ensures that the application window receives all mouse-click messages. Also set the keyboard focus to the application window. When you switch out of full-screen mode, restore the window's original size and position.

By default, the cursor is still visible in full-screen mode. To hide the cursor, call ShowCursor.

The transition to and from full-screen mode occurs asynchronously. To get the current mode, call IMFVideoDisplayControl::GetFullscreen.

Anforderungen

Mindestens unterstützter Client

Windows Vista

Mindestens unterstützter Server

Windows Server 2008

Header

Evr.h

Bibliothek

Strmiids.lib

Siehe auch

Enhanced Video Renderer

Using the Video Display Controls

IMFVideoDisplayControl