|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 class represents a surface allocated, either by the driver or by the Graphics Device Interface (GDI). The surface retains pixels in system memory or, if available on the Windows CE–based platform, in video memory.
Generally, this class is created for all surfaces when the driver allocates memory; for example, in response to the DrvCreateDeviceBitmapfunction. If the GDI allocates the surface, the driver creates a temporary surface of the TmpGPESurfclass, which is derived from this class. This class is a wrapper around the SURFOBJtype created by the GPE. TmpGPESurfobjects persist only for the duration of the call to the display driver.
This class provides a number of methods for a driver to retrieve pointers to pixel data, pixel format, stride, height, and width. In addition, GPESurfretains a flag to indicate whether the data is stored in video memory, which is verified by a call to the GPESurf::InVideoMemorymethod. The class also retains a flag that determines whether memory should be de-allocated when the GPESurfobject is deleted.
Typically, you derive a new surface class based on the GPESurfclass for video memory allocations.
Last updated on Tuesday, July 13, 2004