IDDrawExclModeVideo Interface
| Microsoft DirectShow 9.0 |
IDDrawExclModeVideo Interface
The IDDrawExclModeVideo interface enables video playback in DirectDraw exclusive full-screen mode. The Overlay Mixer Filter implements this interface. Game applications can use DirectDraw in exclusive full-screen mode and continue playing video. For example, the video can be in the background and graphics can be used on top of it. The application passes in a DirectDraw object and primary surface , and these are passed to the Overlay Mixer filter in the filter graph.
The DVD graph builder object uses IDDrawExclModeVideo to play DVD content while in DirectDraw exclusive full-screen mode. This interface can also be used alone to play MPEG-1 or AVI videos in games.
In addition to the methods inherited from IUnknown, the IDDrawExclModeVideo interface exposes the following methods.
| Method | Description |
| GetDDrawObject | Retrieves the DirectDraw object being used by the Overlay Mixer. |
| GetDDrawSurface | Retrieves the DirectDraw surface being used by the Overlay Mixer. |
| GetNativeVideoProps | Retrieves the width, height, and aspect ratio of the Overlay Mixer's primary stream. |
| SetCallbackInterface | Specifies the callback interface to the Overlay Mixer so that the calling application can be notified about adjustments to the display during video playback. |
| SetDDrawObject | Sets the DirectDraw object to be used in subsequent drawing. |
| SetDDrawSurface | Sets the DirectDraw surface to be used in subsequent drawing. |
| SetDrawParameters | Specifies which part of the original video will appear at which position of the screen. |
Requirements
Header: Declared in Strmif.h; include Dshow.h.
Library: Use Strmiids.lib.