IDrawVideoImage 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.]
IDrawVideoImage interface enables an application to draw the same video image in multiple places simultaneously on the screen. The Video Renderer filter exposes this interface. The Video Mixing Renderer (VMR) filter provides a better way to accomplish the same effect, through the use of multiple input streams.
To use this interface, call DrawVideoImageBegin to put the Video Renderer into GDI mode. Then the application can call the DrawVideoImageDraw method as often as necessary. The renderer simply takes the current video frame and draws it to the specified rectangle. This process is asynchronous to the delivery of frames to the renderer on the filter graph thread. The application is responsible for the frame rate at which it renders images; this rate will never be the same as the rate of the frames being delivered to the filter. In other words, calling this method is like taking a periodic snapshot of the video and putting it into a device context of your choosing at a rate of your choosing.
Inheritance
The IDrawVideoImage interface inherits from the IUnknown interface. IDrawVideoImage also has these types of members:
Methods
The IDrawVideoImage interface has these methods.
| IDrawVideoImage::DrawVideoImageBegin Note This interface has been deprecated. New applications should not use it. The DrawVideoImageBegin method turns off DirectDraw in preparation for a call to the DrawVideoImageDraw method. |
| IDrawVideoImage::DrawVideoImageDraw Note This interface has been deprecated. New applications should not use it. The DrawVideoImageDraw method draws the specified source rectangle to the specified destination rectangle in the specified GDI device context. |
| IDrawVideoImage::DrawVideoImageEnd Note This interface has been deprecated. New applications should not use it. The DrawVideoImageEnd method turns DirectDraw back on after drawing has been performed. |
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Windows |
| Header | strmif.h |