IDirectDrawSurface::Restore
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.
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 |
| Windows Embedded CE | Windows Embedded CE 6.0 and later |
| Windows Mobile | Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later |