|
|
<html xmlns:o="urn:schemas-microsoft-com:office:office"xmlns:w="urn:schemas-microsoft-com:office:word"xmlns="http://www.w3.org/TR/REC-html40">
<head><meta http-equiv=Content-Type content="text/html; charset=us-ascii"><meta name=ProgId content=Word.Document><meta name=Generator content="Microsoft Word 10"><meta name=Originator content="Microsoft Word 10"><link rel=File-List href="agp440_files/filelist.xml"><title>AGP440</title><!--[if gte mso 9]><xml>
<w:WordDocument> <w:SpellingState>Clean</w:SpellingState> <w:GrammarState>Clean</w:GrammarState> <w:BrowserLevel>MicrosoftInternetExplorer4</w:BrowserLevel> </w:WordDocument></xml><![endif]--><style><!--
/* Font Definitions */ @font-face {font-family:Verdana; panose-1:2 11 6 4 3 5 4 4 2 4; mso-font-charset:0; mso-generic-font-family:swiss; mso-font-pitch:variable; mso-font-signature:536871559 0 0 0 415 0;}@font-face {font-family:"MS Sans Serif"; panose-1:0 0 0 0 0 0 0 0 0 0; mso-font-alt:"Times New Roman"; mso-font-charset:0; mso-generic-font-family:roman; mso-font-format:other; mso-font-pitch:auto; mso-font-signature:0 0 0 0 0 0;} /* Style Definitions */ p.MsoNormal, li.MsoNormal, div.MsoNormal {mso-style-parent:""; margin:0in; margin-bottom:.0001pt; mso-pagination:widow-orphan; font-size:12.0pt; font-family:"Times New Roman"; mso-fareast-font-family:"Times New Roman";}a:link, span.MsoHyperlink {color:blue; text-decoration:underline; text-underline:single;}a:visited, span.MsoHyperlinkFollowed {color:blue; text-decoration:underline; text-underline:single;}p {mso-margin-top-alt:auto; margin-right:0in; mso-margin-bottom-alt:auto; margin-left:0in; mso-pagination:widow-orphan; font-size:12.0pt; font-family:"Times New Roman"; mso-fareast-font-family:"Times New Roman";}pre {margin:0in; margin-bottom:.0001pt; mso-pagination:widow-orphan; tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt; font-size:10.0pt; font-family:"Courier New"; mso-fareast-font-family:"Times New Roman";}span.SpellE {mso-style-name:""; mso-spl-e:yes;}span.GramE {mso-style-name:""; mso-gram-e:yes;}@page Section1 {size:8.5in 11.0in; margin:1.0in 1.25in 1.0in 1.25in; mso-header-margin:.5in; mso-footer-margin:.5in; mso-paper-source:0;}div.Section1 {page:Section1;}--></style><!--[if gte mso 10]>
<style> /* Style Definitions */ table.MsoNormalTable {mso-style-name:"Table Normal"; mso-tstyle-rowband-size:0; mso-tstyle-colband-size:0; mso-style-noshow:yes; mso-style-parent:""; mso-padding-alt:0in 5.4pt 0in 5.4pt; mso-para-margin:0in; mso-para-margin-bottom:.0001pt; mso-pagination:widow-orphan; font-size:10.0pt; font-family:"Times New Roman";}</style><![endif]--></head>
<body lang=EN-US link=blue vlink=blue style='tab-interval:.5in'>
<div class=Section1>
<h2><span style='font-family:Verdana'>AGP440<o:p></o:p></span></h2>
<p><span style='font-size:10.0pt;font-family:Arial;color:red'>[This ispreliminary documentation and subject to change.]</span><span style='font-size:10.0pt;font-family:Verdana'><o:p></o:p></span></p>
<h3><span style='font-family:Verdana'>SUMMARY<o:p></o:p></span></h3>
<p><span style='font-size:10.0pt;font-family:Verdana'>This is an AGP chipsetdriver sample that shows how to write an AGP driver. The sample works as adriver for the Intel® 440LX/BX® chipset. Currently there is nocorresponding hardware for any 64-bit platform.<o:p></o:p></span></p>
<h3><span style='font-family:Verdana'>BUILDING THE SAMPLE<o:p></o:p></span></h3>
<p><span style='font-size:10.0pt;font-family:Verdana'>The sample is built withthe standard DDK BUILD utility in the standard checked or free DDK buildenvironment. Simply <span class=GramE>type <b>build</b></span> from the\\Ntddk\Src\Kernel\Agp\Agp440 directory. A successful build producesAgp440.sys. <o:p></o:p></span></p>
<p><span style='font-size:10.0pt;font-family:Verdana'>An installation file,Agp440.inf, is provided. Install Agp440.sys by creating an installationdirectory containing the Agp440.sys binary and Agp440.inf.<o:p></o:p></span></p>
<p><span style='font-size:10.0pt;font-family:Verdana'>In the .<spanclass=SpellE>inf</span> file, change the names and PCI IDs as necessary foryour setup. Then, go into <b>Device Manager</b> and right-click on the PCI-PCIbridge that represents your AGP <span class=GramE>bridge</span>. Select <b>Properties</b>.Then select the <b>Driver</b> tab and click the <b>Update Driver</b> button. Followthe prompts in the Update Driver wizard. On the <b>Locate Driver Files</b>page, select <b>Specify a Location</b>, and enter the location of your .<spanclass=SpellE>inf</span> and driver. <o:p></o:p></span></p>
<h3><span style='font-family:Verdana'>COMPATIBILITY<o:p></o:p></span></h3>
<p><span style='font-size:10.0pt;font-family:Verdana'>Although the Agp440.sysdriver, when built in the XP build environment (in conjunction with AGPLIB),will also run on Win2K, and <span style='color:#333333'>Microsoft<sup>®</sup>Windows<sup>®</sup> Server 2003</span>, this has not been extensivelytested. Conversely, when the Agp440.sys driver (and AGPLIB) are built in the <spanstyle='color:#333333'>Windows Server 2003</span> build environment, it will notuse the obsolete HAL APIs <span class=SpellE>HalGet/SetBusDataByOffset</span>,but this type of driver is only compatible on OS versions that support the newAGP_TARGET_BUS_INTERFACE_STANDARD, i.e., XPSP2, <span style='color:#333333'>WindowsServer 2003</span>, and higher.<span style='mso-spacerun:yes'> </span>Therefore, if your goal is building a driver for test and inclusion in afuture OS release, you should build in the <span style='color:#333333'>WindowsServer 2003 </span>build environment, whereas if your goal is to produce abinary that is compatible across the broadest range of OS releases, you shouldbuild in the XP build environment.<span style='mso-spacerun:yes'> </span>(See Agplib.htm for additional compatibility details.)<o:p></o:p></span></p>
<h3><span style='font-family:Verdana'>RESOURCES<o:p></o:p></span></h3>
<p><span style='font-size:10.0pt;font-family:Verdana'>See <ahref="http://intel.com/design/chipsets/440bx/index.htm">http://intel.com/design/chipsets/440bx/index.htm</a>for more information on the AGP chipset. <o:p></o:p></span></p>
<h3><span style='font-family:Verdana'>CODE TOUR<o:p></o:p></span></h3>
<h4><span style='font-family:Verdana'>File Manifest<o:p></o:p></span></h4>
<pre><u>File<span style='mso-tab-count:2'> </span>Description<o:p></o:p></u></pre><pre><o:p> </o:p></pre><pre><spanclass=SpellE>Gart.c</span> <span style='mso-tab-count:2'> </span>Routines for querying and setting the Intel 440xx GART aperture</pre><pre>Agp440.h <spanstyle='mso-tab-count:1'> </span>Additional GART aperture control routines</pre><pre><spanclass=SpellE>Agplib.h</span><span style='mso-tab-count:1'> </span>Private <spanclass=GramE>header</span> file for the common AGP library</pre><pre>Agp440.inf<spanstyle='mso-tab-count:1'> </span>Install file for AGP sample</pre><pre>Agp440.rc<spanstyle='mso-tab-count:1'> </span>Resource template</pre><pre><spanclass=SpellE>Makefile</span><span style='mso-tab-count:1'> </span>Standard Windows NT <spanclass=SpellE>makefile</span></pre><pre>Agp440.htm<span style='mso-tab-count:1'> </span>The documentation for these samples (this file). </pre><pre><o:p> </o:p></pre>
<p align=center style='text-align:center;tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt'><spanstyle='font-size:10.0pt;font-family:"Courier New"'><a href="#top"><spanstyle='font-family:Verdana'>Top of page</span></a></span><spanstyle='font-size:10.0pt;font-family:Verdana;mso-bidi-font-family:"Courier New"'><o:p></o:p></span></p>
<pre><o:p> </o:p></pre>
<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0 width=624 style='width:6.5in;mso-cellspacing:0in;mso-padding-alt:0in 5.4pt 0in 5.4pt'> <tr style='mso-yfti-irow:0;mso-yfti-lastrow:yes;height:1.5pt'> <td style='background:aqua;padding:.75pt .75pt .75pt .75pt;height:1.5pt'> <p class=MsoNormal><o:p> </o:p></p> </td> </tr></table>
<pre><o:p> </o:p></pre><pre><o:p> </o:p></pre>
<p style='tab-stops:45.8pt 91.6pt 137.4pt 183.2pt 229.0pt 274.8pt 320.6pt 366.4pt 412.2pt 458.0pt 503.8pt 549.6pt 595.4pt 641.2pt 687.0pt 732.8pt'><spanstyle='font-size:7.5pt;font-family:"MS Sans Serif";mso-bidi-font-family:"Courier New"'>©1999 Microsoft Corporation</span><span style='font-size:10.0pt;font-family:Verdana;mso-bidi-font-family:"Courier New"'> <o:p></o:p></span></p>
</div>
</body>
</html>
|
