Microsoft DirectX 8.1 (C++)

IDirectDrawVideo::GetSurfaceDesc

The GetSurfaceDesc method retrieves a DDSURFACEDESC structure describing the current DirectDraw surface.

Syntax

HRESULT GetSurfaceDesc(
  DDSURFACEDESC *pSurfaceDesc
);

Parameters

pSurfaceDesc

Pointer to a DDSURFACEDESC structure describing the current DirectDraw surface.

Return Values

Returns an HRESULT value. If no surface has been allocated, this method will return E_FAIL. If a DCI primary surface is in use, the DDSURFACEDESC structure will not be filled in and the call will return S_FALSE.

Remarks

Surfaces are allocated only when the renderer is paused. After the renderer has been paused, it cannot release the surfaces when stopped.

See Also