Share via


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.