IDirectDrawSurface::Restore

Windows Mobile 6.5
A version of this page is also available for
4/8/2010

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


HRESULT Restore();

None.

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.

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.

Headerddraw.h
Libraryddraw.lib
Windows Embedded CEWindows Embedded CE 6.0 and later
Windows MobilePocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later

Community Additions

Show: