Condividi tramite


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.

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

Requirement Value
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