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 |