Partager via

DDGPESurf::DeleteSurface (Windows Embedded CE 6.0)

  • Article

1/6/2010

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
Windows Embedded CE Windows Embedded CE 6.0 and later

See Also

Concepts

DDGPESurf Class
DDGPESurf Class Definition