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
DrvCreateDeviceBitmap	Creates and manages a bitmap with a driver-defined format.
DrvDeleteDeviceBitmap	Deletes a device-managed bitmap.

Drawing Functions

Function	Description
DrvAlphaBlend	Provides bit-block transfer capabilities with alpha blending.
DrvBitBlt	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.
DrvDitherColor	Requests a device to create a brush dithered against a device palette.
DrvFillPath	Paints a closed path for a device-managed surface.
DrvGradientFill	Shades the specified primitives.
DrvLineTo	Draws a single, solid, integer-only cosmetic line.
DrvPlgBlt	Provides rotate bit-block transfer capabilities between combinations of device-managed and GDI-managed surfaces.
DrvRealizeBrush	Realizes a specified brush for a defined surface.
DrvStretchBlt	Allows stretching block transfers among device-managed and GDI-managed surfaces.
DrvStretchBltROP	Performs a stretching bit-block transfer using a ROP.
DrvStrokeAndFillPath	Simultaneously strokes and fills a path.
DrvTransparentBlt	Provides bit-block transfer capabilities with transparency.

Image Color Management Functions

Function	Description
DrvIcmCheckBitmapBits	Checks whether the pixels in the specified bitmap lie within the device gamut of the specified transform.
DrvIcmCreateColorTransform	Creates an ICM color transform.
DrvIcmDeleteColorTransform	Deletes the specified ICM color transform.
DrvIcmSetDeviceGammaRamp	Sets the hardware gamma ramp of the specified display device.

Pointer and Window Management Functions

Function	Description
DrvDescribePixelFormat	Describes the pixel format for a device-specified PDEV by writing a pixel format description to a PIXELFORMATDESCRIPTOR structure.
DrvMovePointer	Moves a pointer to a new position and redraws it.
DrvSaveScreenBits	Saves or restores a specified rectangle of the screen.
DrvSetPixelFormat	Sets the pixel format of a window.
DrvSetPointerShape	Removes the pointer from the screen if the driver has drawn it, and then sets a new pointer shape.

Miscellaneous Functions

Function	Description
DrvDestroyFont	Notifies driver that a font realization is no longer needed; driver can free allocated data structures.
DrvDrawEscape	Implements draw-type escape functions.
DrvEscape	Queries information from a device not available in a device-independent graphics DDI.
DrvFree	Frees storage associated with an indicated data structure.
DrvNotify	Allows a display driver to be notified about certain information by GDI.
DrvSynchronize	Coordinates drawing operations between GDI and a display driver-supported coprocessor device; for engine-managed surfaces only.
DrvSynchronizeSurface	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:

DirectDraw

Direct3D DDI

A list of optional functions for all graphics drivers appears in Optional Graphics Driver Functions.