Microsoft DirectX 8.1 (C++)

IDirectDrawMediaSample::GetSurfaceAndReleaseLock

The GetSurfaceAndReleaseLock method retrieves and unlocks the surface that the sample represents.

Syntax

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

Parameters

ppDirectDrawSurface

[out] Address of a pointer to the sample's IDirectDrawSurface interface.

pRect

[out] Pointer to a variable that receives the address of the rectangle defining the part of the surface that the sample represents.

Return Values

Returns an HRESULT value.

Remarks

The caller should release the returned surface pointer, except when calling the Overlay Mixer filter's implementation of this interface.

See Also