IVMRWindowlessControl interface (strmif.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 IVMRWindowlessControl interface controls how the Video Mixing Renderer Filter 7 (VMR-7) renders a video stream within a container window. Applications must first put the VMR-7 into windowless mode before using this interface.

For the VMR-9, use the IVMRWindowlessControl9 interface.

Inheritance

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

Methods

The IVMRWindowlessControl interface has these methods.

IVMRWindowlessControl::DisplayModeChanged The DisplayModeChanged method informs the VMR that a WM_DISPLAYCHANGE message has been received by the application.
IVMRWindowlessControl::GetAspectRatioMode The GetAspectRatioMode method queries whether the VMR will preserve the aspect ratio of the source video. (IVMRWindowlessControl.GetAspectRatioMode)
IVMRWindowlessControl::GetBorderColor The GetBorderColor method retrieves the current border color used by the VMR.
IVMRWindowlessControl::GetColorKey The GetColorKey method retrieves the current source color key value used by the VMR.
IVMRWindowlessControl::GetCurrentImage The GetCurrentImage method retrieves a copy of the current image being displayed by the VMR.
IVMRWindowlessControl::GetMaxIdealVideoSize The GetMaxIdealVideoSize method retrieves the maximum video size that the VMR can display without incurring significant performance or image quality degradation.
IVMRWindowlessControl::GetMinIdealVideoSize The GetMinIdealVideoSize method retrieves the minimum video size that the VMR can display without incurring significant performance or image quality degradation.
IVMRWindowlessControl::GetNativeVideoSize The GetNativeVideoSize method retrieves the un-stretched video size and aspect ratio of the video.
IVMRWindowlessControl::GetVideoPosition The GetVideoPosition method retrieves the current source and destination rectangles used to display the video.
IVMRWindowlessControl::RepaintVideo The RepaintVideo method repaints the current video frame.
IVMRWindowlessControl::SetAspectRatioMode The SetAspectRatioMode method specifies whether the VMR will preserve the aspect ratio of the source video. (IVMRWindowlessControl.SetAspectRatioMode)
IVMRWindowlessControl::SetBorderColor The SetBorderColor method sets the border color to be used by the VMR.
IVMRWindowlessControl::SetColorKey The SetColorKey method sets the source color key value that the VMR should use.
IVMRWindowlessControl::SetVideoClippingWindow The SetVideoClippingWindow method specifies the container window that video should be clipped to.
IVMRWindowlessControl::SetVideoPosition The SetVideoPosition method sets the source and destination rectangles for the video.

Requirements

Requirement	Value
Minimum supported client	Windows XP with SP1 [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	strmif.h (include Dshow.h)

See also

Using the Video Mixing Renderer