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