IDDrawExclModeVideo::SetDDrawObject

 
Microsoft DirectShow 9.0

IDDrawExclModeVideo::SetDDrawObject

The SetDDrawObject method sets the DirectDraw object to be used in subsequent drawing.

Syntax

  HRESULT SetDDrawObject(
  LPDIRECTDRAW pDDrawObject
);

Parameters

pDDrawObject

[in] Pointer to the IDirectDraw interface on the object to use.

Return Values

Returns an HRESULT value. Possible values include the following.

Return code Description
S_OK Success.
E_INVALIDARG Argument is invalid.
A DirectDraw error code A DirectDraw error is encountered when trying to set the specified surface on the Overlay Mixer.

Remarks

A game application can use this method to share its DirectDraw object with the Overlay Mixer filter, so that the video can be drawn in a specified surface, as set in IDDrawExclModeVideo::SetDDrawSurface.

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also