IVMRWindowlessControl9 interface (vmr9.h)

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The IVMRWindowlessControl9 interface controls how the Video Mixing Renderer Filter 9 (VMR-9) renders a video stream within a container window.

Inheritance

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

Methods

The IVMRWindowlessControl9 interface has these methods.

 
IVMRWindowlessControl9::DisplayModeChanged

The DisplayModeChanged method informs the VMR that a WM_DISPLAYCHANGE message has been received by the application.
IVMRWindowlessControl9::GetAspectRatioMode

The GetAspectRatioMode method retrieves the current aspect ratio display mode.
IVMRWindowlessControl9::GetBorderColor

The GetBorderColor method retrieves the current border color used by the VMR.
IVMRWindowlessControl9::GetCurrentImage

The GetCurrentImage method retrieves a copy of the current image being displayed by the VMR.
IVMRWindowlessControl9::GetMaxIdealVideoSize

The GetMaxIdealVideoSize method retrieves the maximum video size that the VMR can display without incurring significant performance or image quality degradation.
IVMRWindowlessControl9::GetMinIdealVideoSize

The GetMinIdealVideoSize method retrieves the minimum video size that the VMR can display without incurring significant performance or image quality degradation.
IVMRWindowlessControl9::GetNativeVideoSize

The GetNativeVideoSize method retrieves the un-stretched video size and aspect ratio of the video.
IVMRWindowlessControl9::GetVideoPosition

The GetVideoPosition method retrieves the current source and destination rectangles used to display the video.
IVMRWindowlessControl9::RepaintVideo

The RepaintVideo method repaints the current video frame.
IVMRWindowlessControl9::SetAspectRatioMode

The SetAspectRatioMode method sets the current aspect ratio display mode.
IVMRWindowlessControl9::SetBorderColor

The SetBorderColor method sets the border color to be used by the VMR.
IVMRWindowlessControl9::SetVideoClippingWindow

The SetVideoClippingWindow method specifies the container window that video should be clipped to.
IVMRWindowlessControl9::SetVideoPosition

The SetVideoPosition method sets the source and destination rectangles for the video.

Remarks

The VMR-9 supports this interface in windowless and renderless modes only. In windowed mode, QueryInterface returns E_NOINTERFACE. For more information, see VMR Modes of Operation.

Include DShow.h and D3d9.h before Vmr9.h.

Requirements

Requirement Value
Minimum supported client Windows XP with SP2 [desktop apps only]
Minimum supported server Windows Server 2003 R2 [desktop apps only]
Target Platform Windows
Header vmr9.h

See also

Using the Video Mixing Renderer