Microsoft Windows CE 3.0  

DeleteSurface

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

This function deletes a GPEsurface associated with a DirectDraw surface, and releases any memory occupied by that surface. Normally, the destruction of the GPEsurface will 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 DDGPESurfclass.

You should use this function whenever you want to delete a DirectDraw surface that has a GPEsurface associated with it. If your driver frees the memory associated with that surface, the DirectDraw surface's memory, which should match the GPEsurface's memory, will be deallocated by this function.

static void DeleteSurface (
LPDDRAWI_DDRAWSURFACE_LCL
lpDDSurface
);

Parameters

lpDDSurface
A pointer to an existing DirectDraw surface that has a DDGPESurfobject associated with it.

Return Values

The return value is S_OK if the function is successful. Otherwise an error code is returned.



 Last updated on Tuesday, July 13, 2004

© 2004 Microsoft Corporation. All rights reserved.