IVMRWindowlessControl Interface

Microsoft DirectShow 9.0

IVMRWindowlessControl Interface

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.

In addition to the methods inherited from IUnknown, the IVMRWindowlessControl interface exposes the following methods:

Method	Description
DisplayModeChanged	Informs the VMR that a WM_DISPLAYCHANGE message has been received by the application.
GetAspectRatioMode	Queries whether the VMR will preserve the aspect ratio of the source video.
GetBorderColor	Retrieves the current border color used by the VMR.
GetColorKey	Retrieves the current source color key value used by the VMR.
GetCurrentImage	Retrieves a copy of the current image being displayed by the VMR.
GetMaxIdealVideoSize	Retrieves the maximum video size that the VMR can display without incurring significant performance or image quality degradation.
GetMinIdealVideoSize	Retrieves the minimum video size that the VMR can display without incurring significant performance or image quality degradation.
GetNativeVideoSize	Retrieves the un-stretched video size and aspect ratio of the video.
GetVideoPosition	Retrieves the current source and destination rectangles used to display the video.
RepaintVideo	Repaints the current video frame.
SetAspectRatioMode	Specifies whether the VMR will preserve the aspect ratio of the source video.
SetBorderColor	Sets the border color to be used by the VMR.
SetColorKey	Sets the source color key value that the VMR should use
SetVideoClippingWindow	Specifies the container window that video should be clipped to.
SetVideoPosition	Sets the source and destination rectangles for the video.

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.