IDirectDrawSurface::Restore
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();
Parameters
None.
Return Values
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 |
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
Pocket PC: Windows Mobile 5.0 and later
Smartphone: Windows Mobile 5.0 and later
OS Versions: Windows CE 5.01 and later
Header: Ddraw.h.
Library: Ddraw.lib.
See Also
Send Feedback on this topic to the authors