|Microsoft DirectX 9.0|
The GetSurfaceDesc method retrieves a DDSURFACEDESC structure describing the current DirectDraw surface.
HRESULT GetSurfaceDesc( DDSURFACEDESC *pSurfaceDesc );
Pointer to a DDSURFACEDESC structure describing the current DirectDraw surface.
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.
Surfaces are allocated only when the renderer is paused. After the renderer has been paused, it cannot release the surfaces when stopped.