IDirectDrawSurface::Restore (Compact 2013)

  • Article

3/26/2014

This method restores a surface that has been lost. The restore occurs when the surface memory associated with the DirectDrawSurface object has been freed.

Syntax

HRESULT Restore();

Parameters

None.

Return Value

If the method succeeds or if the surface was not already lost, the return value is DD_OK.

If the method fails, the return value may be one of the following error values:

DDERR_GENERIC

DDERR_NOTFOUND

DDERR_EXCLUSIVEMODEALREADYSET

DDERR_INVALIDPARAMS

DDERR_OUTOFMEMORY

DDERR_UNSUPPORTED

For more information on these error codes see DirectDraw Return Values.

Remarks

Use this method to restore surfaces if operations on those surfaces are returning DDERR_SURFACELOST. Some surfaces can be lost when the display is rotated or another process calls IDirectDraw::SetCooperativeLevel with DDSCL_FULLSCREEN. If another process has entered fullscreen mode, calling Restore on a primary surface will result in DDERR_EXCLUSIVEMODEALREADYSET.

Requirements

Header

ddraw.h

Library

ddraw.lib

See Also

Reference

IDirectDrawSurface
DirectDraw Reference
DirectDraw Interfaces
IDirectDrawSurface::IsLost

Other Resources

DirectDraw