IMFVideoDisplayControl interface

Controls how the Enhanced Video Renderer (EVR) displays video.

The EVR presenter implements this interface. To get a pointer to the interface, call IMFGetService::GetService. The service identifier is GUID MR_VIDEO_RENDER_SERVICE. Call GetService on any of the following objects:

  • The Media Session, if the topology contains an instance of the EVR.
  • The EVR media sink.
  • The DirectShow EVR filter.
  • The EVR presenter.

If you implement a custom presenter for the EVR, the presenter can optionally expose this interface as a service.

Members

The IMFVideoDisplayControl interface inherits from the IUnknown interface. IMFVideoDisplayControl also has these types of members:

Methods

The IMFVideoDisplayControl interface has these methods.

MethodDescription
GetAspectRatioMode

Queries how the EVR handles the aspect ratio of the source video.

GetBorderColor

Retrieves the border color for the video.

GetCurrentImage

Retrieves a copy of the current image being displayed by the video renderer.

GetFullscreen

Queries whether the EVR is currently in full-screen mode.

GetIdealVideoSize

Gets the range of sizes that the EVR can display without significantly degrading performance or image quality.

GetNativeVideoSize

Gets the size and aspect ratio of the video, prior to any stretching by the video renderer.

GetRenderingPrefs

Gets various video rendering settings.

GetVideoPosition

Gets the source and destination rectangles for the video.

GetVideoWindow

Gets the clipping window for the video.

RepaintVideo

Gets the current video frame.

SetAspectRatioMode

Specifies how the EVR handles the aspect ratio of the source video.

SetBorderColor

Sets the border color for the video.

SetFullscreen

Sets or unsets full-screen rendering mode.

SetRenderingPrefs

Sets various preferences related to video rendering.

SetVideoPosition

Sets the source and destination rectangles for the video.

SetVideoWindow

Sets the clipping window for the video.

 

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Evr.h

Library

Strmiids.lib

See also

Enhanced Video Renderer
How to Play Media Files with Media Foundation
Media Foundation Interfaces
Using the Video Display Controls

 

 

Show: