Optional Display Driver Functions
In order to reduce driver size, display driver writers usually add only those optional functions that are well supported in video hardware. The display driver can implement the functions listed in the following tables. These functions are sorted into the following categories:
Bitmap Management Functions
Drawing Functions
Image Color Management Functions
Pointer and Window Management Functions
Miscellaneous Functions
Bitmap Management Functions
| Function | Description |
|---|---|
Creates and manages a bitmap with a driver-defined format. |
|
Deletes a device-managed bitmap. |
Drawing Functions
| Function | Description |
|---|---|
Provides bit-block transfer capabilities with alpha blending. |
|
Provides general bit-block transfer capabilities between device-managed surfaces, between GDI-managed standard-format bitmaps, or between a device-managed surface and a GDI-managed standard-format bitmap. |
|
Requests a device to create a brush dithered against a device palette. |
|
Paints a closed path for a device-managed surface. |
|
Shades the specified primitives. |
|
Draws a single, solid, integer-only cosmetic line. |
|
Provides rotate bit-block transfer capabilities between combinations of device-managed and GDI-managed surfaces. |
|
Realizes a specified brush for a defined surface. |
|
Allows stretching block transfers among device-managed and GDI-managed surfaces. |
|
Performs a stretching bit-block transfer using a ROP. |
|
Simultaneously strokes and fills a path. |
|
Provides bit-block transfer capabilities with transparency. |
Image Color Management Functions
| Function | Description |
|---|---|
Checks whether the pixels in the specified bitmap lie within the device gamut of the specified transform. |
|
Creates an ICM color transform. |
|
Deletes the specified ICM color transform. |
|
Sets the hardware gamma ramp of the specified display device. |
Pointer and Window Management Functions
| Function | Description |
|---|---|
Describes the pixel format for a device-specified PDEV by writing a pixel format description to a PIXELFORMATDESCRIPTOR structure. |
|
Moves a pointer to a new position and redraws it. |
|
Saves or restores a specified rectangle of the screen. |
|
Sets the pixel format of a window. |
|
Removes the pointer from the screen if the driver has drawn it, and then sets a new pointer shape. |
Miscellaneous Functions
| Function | Description |
|---|---|
Notifies driver that a font realization is no longer needed; driver can free allocated data structures. |
|
Implements draw-type escape functions. |
|
Queries information from a device not available in a device-independent graphics DDI. |
|
Frees storage associated with an indicated data structure. |
|
Allows a display driver to be notified about certain information by GDI. |
|
Coordinates drawing operations between GDI and a display driver-supported coprocessor device; for engine-managed surfaces only. |
|
Allows drawing operations performed by a device's coprocessor to be coordinated with GDI. |
Display drivers can also optionally implement the Microsoft DirectDraw and/or Direct3D interfaces. See the following sections for details:
A list of optional functions for all graphics drivers appears in Optional Graphics Driver Functions.