Microsoft DirectX 9.0

IDirectDrawStreamSample::GetSurface

Retrieves pointers to the current sample's DirectDraw surface and associated clipping rectangle.

Syntax

HRESULT GetSurface(
  IDirectDrawSurface **ppDirectDrawSurface,
  RECT *pRect
  );

Parameters

ppDirectDrawSurface

[out] Address of a pointer to an IDirectDrawSurface interface that specifies the sample's new surface. Set this parameter to NULL if you don't want to specify a new surface.

pRect

[out] Pointer to a RECT structure that will contain the current sample's clipping rectangle. Set this parameter to NULL if you don't want to retrieve the clipping rectangle.

Return Values

Returns an HRESULT value.

Remarks

Both parameters are optional. All implementations of this interface must support null values as valid parameters. If you retrieve a surface pointer, this method increments its reference count, so you must release the reference.

See Also