Partager via


Display Driver Samples (Windows CE 5.0)

Send Feedback

Sample code for the sample drivers is in %_WINCEROOT%\Public\Common\OAK\Drivers\Display. For the sample display drivers, software acceleration is provided through emulation libraries, and hardware acceleration is limited to two-dimensional graphics operations.

The following table shows files to help you work with monolithic and GPE-based display drivers.

File Description
Winddi.h Contains the core definitions for display and printer device drivers.

Use this file if you are creating a monolithic driver because it describes the entry points, data types, and symbolic constants you need to receive and process drawing requests from GWES.

This file also contains important definitions for you, if you are using GPE. Many GWES data structures propagate through the GPE layer into the GPE objects.

Emul.h Describes the set of raster drawing helpers inside the raster emulation library.

Creating fast raster output is very important, because more than 95 percent of the pixels on a display screen are drawn using raster drawing calls.

The emulation library provides a reasonably good solution for drawing raster data in software. However, if your display device can perform drawing using accelerated hardware, consider using the hardware in place of the raster emulation library.

GPE.h Contains the basic set of data structures and symbol definitions you need to use the GPE library.
GPE source files Contains GPE source files.

Located in %_WINCEROOT%\Public\Common\OAK\Drivers\Display.

The following table shows the features supported by the ATI and MQ200 display drivers.

Element ATI MQ200
Driver name Ddi_ragexl.dll Ddi_mq200.dll
Environment variable BSP_DISPLAY_RAGEXL BSP_DISPLAY_MQ200
Path to source code %_WINCEROOT%\Public\Common\OAK\Drivers\Display\ATI %_WINCEROOT%\Public\Common\OAK\Drivers\Display\MQ200
Color support Yes Yes
Bit depths 16 bpp 16 bpp
Display resolution 640x480

720x480

800x600

1024x768

1280x1024

640x480

800x600

1024x768

1152x864

1280x1024

Software acceleration Yes Yes
Hardware acceleration Yes Yes
Line routines Software and hardware Software and hardware
Blit routines Software and hardware Software and hardware
Mouse cursor Hardware Hardware
Antialiased text support Yes Yes
Dirty rectangle driver No No
Hardware platform restrictions    

The following table shows the features supported by the Media GX and Media GX rotation-enabled display drivers.

Element Media GX Media GX, rotation-enabled
Driver name Ddi_gx.dll Ddi_rgx.dll
Environment variable BSP_DISPLAY_MEDIAGX BSP_DISPLAY_RMEDIAGX
Path to source code %_WINCEROOT%\Public\Common\OAK\CSP\I486\Geode\GXVIDEO %_WINCEROOT%\Public\Common\OAK\CSP\I486\Geode\GXVIDEO
Color support Yes Yes
Bit depths 16 bpp 16 bpp
Display resolution 640x480x60

640x480x72

640x480x75

640x480x85

800x600x60

800x600x72

800x600x75

800x600x85

1024x768x60

1024x768x70

1024x768x75

1024x768x85

1280x1024x60

1280x1024x75

1280x1024x85

720x480 NTSC

720x576 PAL

640x480x60

640x480x72

640x480x75

640x480x85

800x600x60

800x600x72

800x600x75

800x600x85

1024x768x60

1024x768x70

1024x768x75

1024x768x85

1280x1024x60

1280x1024x75

1280x1024x85

720x480 NTSC

720x576 PAL

Software acceleration Yes Yes
Hardware acceleration Yes Yes
Line routines Hardware Hardware
Blit routines Software Software
Mouse cursor Hardware Hardware
Antialiased text support Yes Yes
Dirty rectangle driver No No
Hardware platform restrictions x86 Geode x86 Geode
Notes    

The following table shows the features supported by the VGA flat and VGA rotation-enabled.

Element VGA flat VGA RFLAT
Driver name Ddi_flat.dll Ddi_rflat.dll
Environment variable BSP_DISPLAY_FLAT BSP_DISPLAY_FLAT
Path to source code %_WINCEROOT%\Public\Common\OAK\Drivers\Display\VGAFLAT %_WINCEROOT%\Public\Common\OAK\Drivers\Display\RFLAT
Color support Yes Yes
Bit depths 8, 16, 24, & 32 bpp 8, 16, 24, & 32 bpp
Display resolution No restrictions aside from hardware limits and as supported by VESA BIOS No restrictions aside from hardware limits and as supported by VESA BIOS.
Software acceleration Yes Yes
Hardware acceleration No No
Line routines Software Software
Blit routines Software Software
Mouse cursor Software Software
Antialiased text support Yes Yes
Dirty rectangle driver No No
Hardware platform restrictions x86 only x86 only
Notes Requires VESA BIOS version 2.0 or later.

Run Vesatest.exe to verify compatibility and needed modes.

Requires VESA BIOS version 2.0 or later.

Run Vesatest.exe to verify compatibility and needed modes.

See Also

How to Decide Whether to Use GPE in a Display Driver | FLAT Sample Display Driver | ATI Sample Display Driver | ATI Sample Display Driver Optimization | Sample DrvEscape Function | Sample Blit Acceleration | Display Driver Performance Profiling | Display Driver Registry Settings | Display Driver Development Concepts | Display Driver Extensions | Display Driver Recommendations

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.