| Microsoft DirectX 9.0 |
The IsLost method determines if the surface memory associated with a DirectDrawSurface has been freed. If the memory has not been freed, this method will return DD_OK. The Restore method can be used to reallocate surface memory. When a DirectDrawSurface object loses its surface memory, most methods will return DDERR_SURFACELOST and perform no other function.
Surfaces can lose their memory when the mode of the display card is changed, or because an application received exclusive access to the display card and freed all of the surface memory currently allocated on the video card.
Syntax
HRESULT IsLost();
Parameters
This method takes no parameters.
Return Values
| Value | Description |
| DD_OK | The method succeeded. |
| DDERR_INVALIDOBJECT | DirectDraw received a pointer that was an invalid DirectDraw object. |
| DDERR_INVALIDPARAMS | One or more of the input parameters is invalid. |
| DDERR_SURFACELOST | Access to this surface is being refused because the surface memory is gone. The DirectDrawSurface object representing this surface should have Restore called on it. |
See Also