IMFVideoDisplayControl interface (evr.h)

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.

Inheritance

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

Methods

The IMFVideoDisplayControl interface has these methods.

 
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