Share via


DDI Functions (Windows CE 5.0)

Send Feedback

All display drivers must implement the DDI functions. However, only DrvEnableDriver must be exported from the display driver's DLL, which means that only DrvEnableDriver can use this exact name.

If your display driver must use the PCI information in the registry, as populated by the PCI bus driver, it needs to implement and export DisplayInit.

You can customize the names for other functions because they are exposed to the GDI through function pointers that are returned by DrvEnableDriver. Regardless of name, all functions must follow the prototypes in the Winddi.h header file.

The following table shows the DDI functions that display drivers must include.

Function Description
DisplayInit Passes instance information, which allows the driver to find PCI configuration information for its device.

The PCI bus driver populates the information if the driver has a PCI template in the registry. This is the first display driver function called by GWES.

DrvAnyBlt Performs bit block transfers, with stretching or transparency.
DrvBitBlt Performs general bit block transfers, with clipping and masking.

Maps to the MoveToEx, Polygon, Polyline, Ellipse, Rectangle, PolyBezier, SetPixel, BitBlt, MaskBlt, Rectangle, ExtTextOut, DrawText, and ExtTextOut GDI functions.

DrvCopyBits Sends a GDI-created print band to a printer driver.

Maps to the SetDIBitsToDevice GDI function.

DrvCreateDeviceBitmap Creates and manages bitmap files.
DrvDeleteDeviceBitmap Deletes a device bitmap file.
DrvDisableDriver Notifies the display driver that the GDI no longer needs it and is ready to unload the driver.
DrvDisablePDEV Notifies the driver that the GDI no longer needs a particular display device.
DrvDisableSurface Notifies the driver that the GDI no longer needs a particular drawing surface.
DrvEnableDriver Returns pointers to DDI functions to GDI. The initial entry point that is exposed by the driver. The driver exposes the second entry point if DisplayInit is implemented.
DrvEnablePDEV Returns a PDEV structure to the GDI. A PDEV structure is a logical representation of a physical display device.
DrvEnableSurface Creates a drawing surface and associates it with PDEV.
DrvEndDoc Sends any control information that is needed to finish printing a document.
DrvEscape Retrieves information from a device that is not available in a device-independent DDI. This function operates the same as with Windows NT, except that Windows CE does not support the DrvDrawEscape function.
DrvFillPath Fills a drawing path with a brush.

Maps to the MoveToEx, Polygon, Polyline, Ellipse, Rectangle, and PolyBezier GDI functions.

DrvGetMasks Gets the color masks for the display device's current mode.
DrvGetModes Lists the display modes that are supported by the display device.
DrvMovePointer Moves the pointer with a guarantee that the GDI will not interfere with the operation.
DrvPaint Paints a specified region with a brush.

Maps to the MoveToEx, Polygon, Polyline, Ellipse, Rectangle, and PolyBezier GDI functions.

DrvPowerHandler Called to handle POWER_UP and POWER_DOWN notifications.
DrvRealizeBrush Creates a brush with parameters that are specified by the GDI.
DrvRealizeColor Maps an RGB color onto the closest available color that is supported by the device.
DrvSetPalette Sets the display device's palette.
DrvSetPointerShape Sets the pointer to a new shape and updates the display.
DrvStartDoc Sends any control information that is needed to start printing a document.
DrvStartPage Sends any control information that is needed to start printing a new page.
DrvStrokePath Renders a drawing path.

Maps to the MoveToEx, Polygon, Polyline, Ellipse, Rectangle, and PolyBezier GDI functions.

DrvStrokeAndFillPath Maps to the MoveToEx, Polygon, Polyline, Ellipse, Rectangle, and PolyBezier GDI functions.
DrvTransparentBlt Bit block transfer, with transparency.
DrvUnrealizeColor Maps a color in the display device's format onto an RGB value.

See Also

Display Drivers | Display Driver Extensions | Display Driver Samples | Primary Display Drivers | Secondary Display Drivers | BitBlT Emulation Library Functions | GPE Base Classes | GDI Support Services | Display Buffer Formats | Line Drawing | Display Driver Escape Codes | Display Drivers and the Run-Time Image

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.