IDirectDrawSurface::Restore (Compact 2013)
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