You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
312 lines
12 KiB
312 lines
12 KiB
<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="uagp35_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";}
|
|
h2
|
|
{mso-margin-top-alt:auto;
|
|
margin-right:0in;
|
|
mso-margin-bottom-alt:auto;
|
|
margin-left:0in;
|
|
mso-pagination:widow-orphan;
|
|
mso-outline-level:2;
|
|
font-size:18.0pt;
|
|
font-family:"Times New Roman";
|
|
font-weight:bold;}
|
|
h3
|
|
{mso-margin-top-alt:auto;
|
|
margin-right:0in;
|
|
mso-margin-bottom-alt:auto;
|
|
margin-left:0in;
|
|
mso-pagination:widow-orphan;
|
|
mso-outline-level:3;
|
|
font-size:13.5pt;
|
|
font-family:"Times New Roman";
|
|
font-weight:bold;}
|
|
h4
|
|
{mso-margin-top-alt:auto;
|
|
margin-right:0in;
|
|
mso-margin-bottom-alt:auto;
|
|
margin-left:0in;
|
|
mso-pagination:widow-orphan;
|
|
mso-outline-level:4;
|
|
font-size:12.0pt;
|
|
font-family:"Times New Roman";
|
|
font-weight:bold;}
|
|
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;}
|
|
/* List Definitions */
|
|
@list l0
|
|
{mso-list-id:824517534;
|
|
mso-list-type:hybrid;
|
|
mso-list-template-ids:1007817362 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
|
|
@list l0:level1
|
|
{mso-level-number-format:bullet;
|
|
mso-level-text:\F0B7;
|
|
mso-level-tab-stop:.5in;
|
|
mso-level-number-position:left;
|
|
text-indent:-.25in;
|
|
font-family:Symbol;}
|
|
@list l0:level2
|
|
{mso-level-tab-stop:1.0in;
|
|
mso-level-number-position:left;
|
|
text-indent:-.25in;}
|
|
@list l0:level3
|
|
{mso-level-tab-stop:1.5in;
|
|
mso-level-number-position:left;
|
|
text-indent:-.25in;}
|
|
@list l0:level4
|
|
{mso-level-tab-stop:2.0in;
|
|
mso-level-number-position:left;
|
|
text-indent:-.25in;}
|
|
@list l0:level5
|
|
{mso-level-tab-stop:2.5in;
|
|
mso-level-number-position:left;
|
|
text-indent:-.25in;}
|
|
@list l0:level6
|
|
{mso-level-tab-stop:3.0in;
|
|
mso-level-number-position:left;
|
|
text-indent:-.25in;}
|
|
@list l0:level7
|
|
{mso-level-tab-stop:3.5in;
|
|
mso-level-number-position:left;
|
|
text-indent:-.25in;}
|
|
@list l0:level8
|
|
{mso-level-tab-stop:4.0in;
|
|
mso-level-number-position:left;
|
|
text-indent:-.25in;}
|
|
@list l0:level9
|
|
{mso-level-tab-stop:4.5in;
|
|
mso-level-number-position:left;
|
|
text-indent:-.25in;}
|
|
ol
|
|
{margin-bottom:0in;}
|
|
ul
|
|
{margin-bottom:0in;}
|
|
-->
|
|
</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'>UAGP35<o:p></o:p></span></h2>
|
|
|
|
<p><span style='font-size:10.0pt;font-family:Arial;color:red'>[This is
|
|
preliminary 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 the Universal
|
|
AGPv3.5 chipset driver. This driver works on any (v3.5) chipset that is
|
|
compatible with the AGP3 Specification from Intel®. Currently there is no
|
|
corresponding hardware for any 64-bit platform.<o:p></o:p></span></p>
|
|
|
|
<h3><span style='font-family:Verdana'>REQUIREMENTS<o:p></o:p></span></h3>
|
|
|
|
<p style='margin-left:.5in;text-indent:-.25in;mso-list:l0 level1 lfo2;
|
|
tab-stops:list .5in'><![if !supportLists]><span style='font-size:10.0pt;
|
|
mso-bidi-font-size:12.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
|
|
mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
|
|
style='font:7.0pt "Times New Roman"'>
|
|
</span></span></span><![endif]><span style='font-size:10.0pt;mso-bidi-font-size:
|
|
12.0pt;font-family:Verdana'>The AGP target capability version must not change,
|
|
i.e., when an AGP2 master device is present, the target capability must remain
|
|
v3.5.<o:p></o:p></span></p>
|
|
|
|
<p style='margin-left:.5in;text-indent:-.25in;mso-list:l0 level1 lfo2;
|
|
tab-stops:list .5in'><![if !supportLists]><span style='font-size:10.0pt;
|
|
mso-bidi-font-size:12.0pt;font-family:Symbol;mso-fareast-font-family:Symbol;
|
|
mso-bidi-font-family:Symbol'><span style='mso-list:Ignore'>·<span
|
|
style='font:7.0pt "Times New Roman"'>
|
|
</span></span></span><![endif]><span style='font-size:10.0pt;mso-bidi-font-size:
|
|
12.0pt;font-family:Verdana'>The AGPv3.5 capability block, and Aperture Base
|
|
register must reside in a single PCI device/function, i.e., for PCI_CAPABILITY_ID_AGP
|
|
systems this is typically PCI bus 0, device 0, function 0, whereas with the new
|
|
PCI_CAPABILITY_ID_AGP_TRAGET, these registers simply reside in the PCI-to-PCI
|
|
bridge device/function on which the driver is loaded.<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 with
|
|
the standard DDK BUILD utility in the standard checked or free DDK build
|
|
environment. Simply <span class=GramE>type <b>build</b></span> from the
|
|
\\Ntddk\Src\Kernel\Agp\Ugp35 directory. A successful build produces Ugp35.sys. <o:p></o:p></span></p>
|
|
|
|
<p><span style='font-size:10.0pt;font-family:Verdana'>An installation file,
|
|
Uagp35.inf, is provided. Install Uagp35.sys by creating an installation
|
|
directory containing the Uagp35.sys binary and Uagp35.inf.<o:p></o:p></span></p>
|
|
|
|
<p><span style='font-size:10.0pt;font-family:Verdana'>In the .<span
|
|
class=SpellE>inf</span> file, change the names and PCI IDs as necessary for
|
|
your setup. Then, go into <b>Device Manager</b> and right-click on the PCI-PCI
|
|
bridge that represents your AGPv3.5 <span class=GramE>bridge</span>. Select <b>Properties</b>.
|
|
Then select the <b>Driver</b> tab and click the <b>Update Driver</b> button.
|
|
Follow the 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 .<span
|
|
class=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 Uagp35.sys
|
|
driver, 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 extensively
|
|
tested. Conversely, when the Uagp35.sys driver (and AGPLIB) are built in the <span
|
|
style='color:#333333'>Windows Server 2003</span> build environment, it will not
|
|
use the obsolete HAL APIs <span class=SpellE>HalGet/SetBusDataByOffset</span>,
|
|
but this type of driver is only compatible on OS versions that support the new
|
|
AGP_TARGET_BUS_INTERFACE_STANDARD, i.e., XPSP2, <span style='color:#333333'>Windows
|
|
Server 2003</span>, and higher.<span style='mso-spacerun:yes'>
|
|
</span>Therefore, if your goal is building a driver for test and inclusion in a
|
|
future OS release, you should build in the <span style='color:#333333'>Windows
|
|
Server 2003</span> 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.<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 <a
|
|
href="http://developer.intel.com/technology/agp/agp_3_spec.htm">http://developer.intel.com/technology/agp/agp_3_spec.htm</a>
|
|
for more information on AGP3 HW design. <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><span
|
|
class=SpellE>Gart.c</span> <span style='mso-tab-count:2'> </span>Routines for querying and setting the AGPv3.5 GART aperture</pre><pre>Uagp35.h <span
|
|
style='mso-tab-count:1'> </span>Additional GART aperture control routines</pre><pre>Uagp35.inf<span
|
|
style='mso-tab-count:1'> </span>Install file for AGP sample</pre><pre>Uagp35.rc<span
|
|
style='mso-tab-count:1'> </span>Resource template</pre><pre><span
|
|
class=SpellE>Makefile</span><span style='mso-tab-count:1'> </span>Standard Windows NT <span
|
|
class=SpellE>makefile</span></pre><pre>Uagp35.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'><span
|
|
style='font-size:10.0pt;font-family:"Courier New"'><a href="#top"><span
|
|
style='font-family:Verdana'>Top of page</span></a></span><span
|
|
style='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'><span
|
|
style='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>
|