GDI Support Services for Display Drivers

The Windows CE GDI provides some services to support display drivers as predefined structures. The structures interact both with associated functions and with a few stand-alone C functions. Predefined structures provide support for brushes, palettes, translations, clipping regions, and stroke and fill paths. Stand-alone C functions provide support for device bitmaps and surfaces. The following table shows the structures and functions.

Structure or function
Description
BRUSHOBJ Structure that represents a brush used for solid or patterned stroke and fill operations
BRUSHOBJ_pvAllocRbrush Function that allocates memory for a brush
BRUSHOBJ_pvGetRbrush Function that retrieves a pointer to the specified brush
CLIPOBJ Structure that represents a clipping region
CLIPOBJ_bEnum Function that enumerates clipping rectangles from a clipping region
CLIPOBJ_cEnumStart Function that sets parameters for enumerating the rectangles in a clipping region
EngCreateDeviceBitmap Function that causes the GDI to create a handle for a device bitmap
EngCreateDeviceSurface Function that causes the GDI to create a device surface that the display driver manages
EngDeleteSurface Function that informs the GDI that a device surface no longer is needed by the display driver
PALOBJ_cGetColors Function that copies colors into a palette
PATHDATA Structure that stores portions of a drawing path
PATHOBJ_bEnum Function that enumerates PATHDATA records from a drawing path
PATHOBJ_vEnumStart Function that readies a drawing path to have its component line segments enumerated
PATHOBJ_vGetBounds Function that returns the bounding rectangle for a drawing path
XLATEOBJ Structure used in translating colors from one palette to another
XLATEOBJ_cGetPalette Function that retrieves colors from an indexed palette