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.

Methods

The IMFVideoDisplayControl interface has these methods.

Method Description
IMFVideoDisplayControl::GetAspectRatioMode Queries how the enhanced video renderer (EVR) handles the aspect ratio of the source video.
IMFVideoDisplayControl::GetBorderColor Gets the border color for the video.
IMFVideoDisplayControl::GetCurrentImage Gets a copy of the current image being displayed by the video renderer.
IMFVideoDisplayControl::GetFullscreen Queries whether the enhanced video renderer (EVR) is currently in full-screen mode.
IMFVideoDisplayControl::GetIdealVideoSize Gets the range of sizes that the enhanced video renderer (EVR) can display without significantly degrading performance or image quality.
IMFVideoDisplayControl::GetNativeVideoSize Gets the size and aspect ratio of the video, prior to any stretching by the video renderer.
IMFVideoDisplayControl::GetRenderingPrefs Gets various video rendering settings.
IMFVideoDisplayControl::GetVideoPosition Gets the source and destination rectangles for the video.
IMFVideoDisplayControl::GetVideoWindow Gets the clipping window for the video.
IMFVideoDisplayControl::RepaintVideo Repaints the current video frame. Call this method whenever the application receives a WM_PAINT message.
IMFVideoDisplayControl::SetAspectRatioMode Specifies how the enhanced video renderer (EVR) handles the aspect ratio of the source video.
IMFVideoDisplayControl::SetBorderColor Sets the border color for the video.
IMFVideoDisplayControl::SetFullscreen Sets or unsets full-screen rendering mode.
IMFVideoDisplayControl::SetRenderingPrefs Sets various preferences related to video rendering.
IMFVideoDisplayControl::SetVideoPosition Sets the source and destination rectangles for the video.
IMFVideoDisplayControl::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]
Target Platform Windows
Header evr.h

See Also

Enhanced Video Renderer

How to Play Media Files with Media Foundation

Media Foundation Interfaces

Using the Video Display Controls