IDDrawExclModeVideo 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 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.
Inheritance
The IDDrawExclModeVideo interface inherits from the IUnknown interface. IDDrawExclModeVideo also has these types of members:
Methods
The IDDrawExclModeVideo interface has these methods.
| IDDrawExclModeVideo::GetDDrawObject The GetDDrawObject method retrieves the DirectDraw object being used by the Overlay Mixer filter. |
| IDDrawExclModeVideo::GetDDrawSurface The GetDDrawSurface method retrieves the DirectDraw surface being used by the Overlay Mixer. |
| IDDrawExclModeVideo::GetNativeVideoProps The GetNativeVideoProps method retrieves the current video size and picture aspect ratio of the Overlay Mixer's primary stream. |
| IDDrawExclModeVideo::SetCallbackInterface The SetCallbackInterface method retrieves a pointer to the callback interface of the Overlay Mixer so that the calling application can be notified about adjustments to the display during video playback. |
| IDDrawExclModeVideo::SetDDrawObject The SetDDrawObject method sets the DirectDraw object to be used in subsequent drawing. |
| IDDrawExclModeVideo::SetDDrawSurface The SetDDrawSurface method specifies the DirectDraw surface to be used in subsequent drawing. |
| IDDrawExclModeVideo::SetDrawParameters The SetDrawParameters method specifies which part of the original video will appear at which position of the screen. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | strmif.h (include Dshow.h) |