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.
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 |