AGP440

[This is preliminary documentation and subject to change.]

SUMMARY

This is an AGP chipset driver sample that shows how to write an AGP driver. The sample works as a driver for the Intel® 440LX/BX® chipset. Currently there is no corresponding hardware for any 64-bit platform.

BUILDING THE SAMPLE

The sample is built with the standard DDK BUILD utility in the standard checked or free DDK build environment. Simply type build from the \\Ntddk\Src\Kernel\Agp\Agp440 directory. A successful build produces Agp440.sys.

An installation file, Agp440.inf, is provided. Install Agp440.sys by creating an installation directory containing the Agp440.sys binary and Agp440.inf.

In the .inf file, change the names and PCI IDs as necessary for your setup. Then, go into Device Manager and right-click on the PCI-PCI bridge that represents your AGP bridge. Select Properties. Then select the Driver tab and click the Update Driver button. Follow the prompts in the Update Driver wizard. On the Locate Driver Files page, select Specify a Location, and enter the location of your .inf and driver.

COMPATIBILITY

Although the Agp440.sys driver, when built in the XP build environment (in conjunction with AGPLIB), will also run on Win2K, and Microsoft® Windows® Server 2003, this has not been extensively tested. Conversely, when the Agp440.sys driver (and AGPLIB) are built in the Windows Server 2003 build environment, it will not use the obsolete HAL APIs HalGet/SetBusDataByOffset, but this type of driver is only compatible on OS versions that support the new AGP_TARGET_BUS_INTERFACE_STANDARD, i.e., XPSP2, Windows Server 2003, and higher.  Therefore, if your goal is building a driver for test and inclusion in a future OS release, you should build in the Windows Server 2003 build environment, whereas if your goal is to produce a binary that is compatible across the broadest range of OS releases, you should build in the XP build environment.  (See Agplib.htm for additional compatibility details.)

RESOURCES

See http://intel.com/design/chipsets/440bx/index.htm for more information on the AGP chipset.

CODE TOUR

File Manifest

File           Description
 
Gart.c         Routines for querying and setting the Intel 440xx GART aperture
Agp440.h       Additional GART aperture control routines
Agplib.h       Private header file for the common AGP library
Agp440.inf     Install file for AGP sample
Agp440.rc      Resource template
Makefile       Standard Windows NT makefile
Agp440.htm     The documentation for these samples (this file). 
 

Top of page

 

 

 
 

© 1999 Microsoft Corporation