DDGPESurf::DeleteSurface (Compact 2013)
3/26/2014
This method deletes a GPE surface associated with a DirectDraw surface and releases memory occupied by that surface. Typically, the destruction of the GPE surface also cause its associated surface video or system memory to be deallocated as well. This is often a function of the destructor in a concrete driver's derivation of the DDGPESurf class.
Syntax
static void DeleteSurface(
LPDDRAWI_DDRAWSURFACE_LCL lpDDSurface
);
Parameters
- lpDDSurface
A pointer to an existing DirectDraw surface that has a DDGPESurf object associated with it.
Return Value
The return value is S_OK, if the method is successful. Otherwise, an error code is returned.
Remarks
Use this method whenever you want to delete a DirectDraw surface that has a GPE surface associated with it. If your driver frees the memory associated with that surface, the DirectDraw surface's memory, which should match the GPE surface's memory, will be deallocated by this method.
Requirements
Header |
ddgpe.h |
Library |
Ddgpe.lib |