Share via

IMFVideoDisplayControl interface (evr.h)

[The component described on this page, Enhanced Video Renderer, is a legacy feature. It has been superseded by the Simple Video Renderer (SVR) exposed through the MediaPlayer and IMFMediaEngine components. To play video content you should send data into one of these components and allow them to instantiate the new video renderer. These components have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer or the lower level IMFMediaEngine APIs to play video media in Windows instead of the EVR, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

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.


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


The IMFVideoDisplayControl interface has these methods.


Queries how the enhanced video renderer (EVR) handles the aspect ratio of the source video.

Gets the border color for the video.

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

Queries whether the enhanced video renderer (EVR) is currently in full-screen mode.

Gets the range of sizes that the enhanced video renderer (EVR) can display without significantly degrading performance or image quality.

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

Gets various video rendering settings.

Gets the source and destination rectangles for the video.

Gets the clipping window for the video.

Repaints the current video frame. Call this method whenever the application receives a WM_PAINT message.

Specifies how the enhanced video renderer (EVR) handles the aspect ratio of the source video.

Sets the border color for the video.

Sets or unsets full-screen rendering mode.

Sets various preferences related to video rendering.

Sets the source and destination rectangles for the video.

Sets the clipping window for the video.


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