Microsoft Windows CE 3.0  

Using the GPE Classes

This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

All sample display drivers included with the Platform Builder use the GPE classes. Although the GPE classes are optional, using them greatly facilitates the process of writing display drivers. If you use the GPE classes, you need only provide the new code that is necessary to make your display hardware operate correctly and perform acceleration.

The GPE classes require that your display hardware use a linear-frame buffer; that is, the display's memory must lie in a contiguous memory range. Modifying the GPE classes to use a non-contiguous frame buffer would require significant effort.

To create a display driver based on the GPE classes

  1. Create a directory for your project.
  2. Copy the files from one of the sample driver directories, such as the CEPC\Drivers\Display\ATI directory, to your project directory.
  3. Replace all device-specific names in those files with your device's name.
  4. Change the card initialization and mode-setting code so that it places your display device in a linear frame-buffer mode. For an example of this type of code, see the InitializeCardand SetModefunctions in the ATI sample driver.
  5. Disable all hardware-specific acceleration.
  6. Build and test this non-accelerated driver.
  7. Add your own hardware acceleration code.

    For more information about GPE classes and methods, see the Microsoft Windows CE API Reference.

     Last updated on Tuesday, July 13, 2004

    © 2004 Microsoft Corporation. All rights reserved.