 Important: |
|---|
| 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. |
This section describes the steps required to extend your display driver using the DDGPEC++ classes.
The DDGPEC++ classes extend the functionality of GPEin order to support the inclusion of a DirectDraw Hardware Abstraction Layer (DDHAL). To add this functionality, you will need to make a few minor and nondestructive changes to your source code.
Before you begin, you will need to know the location of the following things:
- The contents of the DDGPEpackage (ddgpe.lib and ddgpe.h).
- The build file containing information to link your device driver to gpe.lib (usually called sources).
- The header file containing your device-specific declaration of a GPE-derived class.
- The source code file containing the constructor of the device-specific derivation of the GPEclass, along with any other files that include the gpe.h header file.
- Any header files containing the device-specific derivation of the GPESurfclass.
- Any source code files referencing the
GPESurfclass directly (for example, constructors for any
derived classes).
Place ddgpe.lib in the appropriate library directory path, and put ddgpe.h in the appropriate header directory path. Then make the changes in your build file to link to ddgpe.lib (in addition to gpe.lib, which should already exist). Depending on your build environment, you might have to add it as one of your SOURCELIBentries, in order for HALInitto be exported properly by your linker.
Next, change the header file defining your device-specific class to derive directly from DDGPEinstead of GPE. Then make any necessary changes to your constructors or other functions to accommodate this change of base class. Change the files that include gpe.h to include ddgpe.h, instead.
Now change any header files deriving from the GPESurfclass (these may or may not be present in your display driver), to derive from DDGPESurf, instead. Your source code should be changed to accommodate this change of base class. You should be sure that your code always refers to DDGPESurfwhere it would normally have referred to GPESurf.
You should now recompile your display driver and test it to be sure that it still works properly. When you have verified that it continues to work properly, you may continue to the next step.
Last updated on Tuesday, July 13, 2004