Conditionally Required Display Driver Functions

Depending on how a driver is implemented and on the features of the underlying adapter, other graphics DDI functions may be required. For example, if a driver manages its own surface (using EngCreateDeviceSurface to get a handle to the surface), that driver must also, at a minimum, support the following drawing functions:

Function Description

DrvCopyBits

Translates between device-managed raster surfaces and GDI standard-format bitmaps.

DrvStrokePath

Draws a path (curve or line) when called by GDI.

DrvTextOut

Renders a set of glyphs at specified positions.

Note   Driver calls are serialized for any given surface.

Drivers that write to standard-format DIBs usually allow GDI to manage most or all of these operations. Displays that support settable palettes must support the DrvSetPalette function.

Function Description

DrvSetPalette

Requests that the driver realize the palette for a specified device. The driver sets the hardware palette to match the entries in the given palette as closely as possible.

A list of conditionally required functions for all graphics drivers appears in Conditionally Required Graphics Driver Functions.