windows-nt/Source/XPSP1/NT/drivers/ddk/wdmaudio/gfx/gfxswap/driver
..
common.h
debug.h
device.cpp
filter.cpp
filter.h
gfx.rc
makefile
pin.cpp
pin.h
readme.htm
sources

<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=windows-1252">
<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="readme_files/filelist.xml">
<title>AC97</title>
<!--[if gte mso 9]><xml>
 <w:WordDocument>
  <w:Zoom>90</w:Zoom>
  <w:SpellingState>Clean</w:SpellingState>
  <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-charset:0;
	mso-generic-font-family:swiss;
	mso-font-format:other;
	mso-font-pitch:variable;
	mso-font-signature:3 0 0 0 1 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:"Courier New";}
span.SpellE
	{mso-style-name:"";
	mso-spl-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'>Audio GFX Filter Sample<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 sample driver demonstrates
the basics of writing an audio GFX filter. On Microsoft Windows XP, only <span
class=SpellE>autoload</span> <span class=SpellE>GFXes</span> are allowed. That
means that a GFX can only be applied to specific PnP IDs of USB audio devices.
The sample GFX is therefore tied to the Microsoft DSS 80 USB speakers. You can
modify the INF file and replace the PnP ID with the PnP ID of your USB audio
device to load the GFX on your device.<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'>To build this sample,
enter the free or checked Windows XP build environment and run <b>build</b>
from the parent directory, rather than this subdirectory. This will also
compile the GFX property DLL which allows the user to change the properties of
your GFX.<o:p></o:p></span></p>

<p><span style='font-size:10.0pt;font-family:Verdana'>The INF file named <20><span
class=SpellE>gfxswap.inf</span><3E> included in the parent directory can be used
to install the sample driver together with the GFX property DLL after it has
been built. Simply copy the INF and this binary and the GFX property sample
binary to a floppy disk and right click the INF file and choose <20>Install<6C> on
your test machine. Please also refer to the <20>readme.htm<74> file in the parent
directory.<o:p></o:p></span></p>

<p><span style='font-size:10.0pt;font-family:Verdana'>Once the driver has been
installed with the INF, the driver may be updated by copying the binary into
%SystemRoot%\System32\Drivers on the target machine and rebooting to test the
new driver, provided that there are no INF changes.<o:p></o:p></span></p>

<h3><span style='font-family:Verdana'>DRIVER ISSUES<o:p></o:p></span></h3>

<h3><span style='font-size:10.0pt;mso-bidi-font-size:13.5pt;font-family:Verdana;
font-weight:normal'>This sample only works with </span><span style='font-size:
10.0pt;font-family:Verdana;font-weight:normal'>Microsoft<66> Windows<77> XP (or
higher)</span><span style='font-size:10.0pt;font-family:Verdana'> </span><span
style='font-size:10.0pt;font-family:Verdana;font-weight:normal'>operating
system.</span><span style='font-size:10.0pt;mso-bidi-font-size:13.5pt;
font-family:Verdana;font-weight:normal'><o:p></o:p></span></h3>

<h3><span lang=FR style='font-family:Verdana;mso-ansi-language:FR'>CODE TOUR<o:p></o:p></span></h3>

<h4><span lang=FR style='font-family:Verdana;mso-ansi-language:FR'>File <span
class=SpellE>Manifest</span><o:p></o:p></span></h4>

<pre><u><span lang=FR style='mso-ansi-language:FR'>File<span style='mso-tab-count:
2'><3E><><A0><A0><A0><A0><A0><A0><A0><A0> </span>Description<o:p></o:p></span></u></pre><pre><span lang=FR
style='mso-ansi-language:FR'><o:p>&nbsp;</o:p></span></pre><pre><span
class=SpellE>common.h</span><span style='mso-tab-count:1'><3E><><A0><A0><A0><A0> </span>Header file which includes all necessary header files.<o:p></o:p></pre><pre><span
class=SpellE>debug.h</span><span style='mso-tab-count:2'><3E><><A0><A0><A0><A0><A0> </span>Defines debug output macros.<o:p></o:p></pre><pre><span
class=SpellE>device.cpp</span><span style='mso-tab-count:1'><3E><><A0><A0> </span>Device entry point.<o:p></o:p></pre><pre><span
class=SpellE>filter.cpp</span><span style='mso-tab-count:1'><3E><><A0><A0> </span>Defines the filter and implements all filter properties.<o:p></o:p></pre><pre><span
class=SpellE>filter.h</span><span style='mso-tab-count:1'><3E><><A0><A0><A0><A0> </span>Defines the filter object and the filter property handlers.<o:p></o:p></pre><pre><span
class=SpellE>gfx.rc</span><span style='mso-tab-count:2'><3E><><A0><A0><A0><A0><A0><A0> </span>Recourse file to build the filter.<o:p></o:p></pre><pre><span
class=SpellE>Makefile</span><span style='mso-tab-count:1'><3E><><A0><A0><A0><A0> </span><span
class=SpellE>Makefile</span> <20><o:p></o:p></pre><pre><span class=SpellE>pin.cpp</span><span
style='mso-tab-count:2'><3E><><A0><A0><A0><A0><A0> </span>Implements the pin dispatch handlers and properties.<o:p></o:p></pre><pre><span
class=SpellE>pin.h</span><span style='mso-tab-count:2'><3E><><A0><A0><A0><A0><A0><A0><A0> </span>Defines the pin object and pin property handlers.<o:p></o:p></pre><pre>readme.htm<span
style='mso-tab-count:1'><3E><><A0><A0> </span>This file.<o:p></o:p></pre><pre>Sources<span
style='mso-tab-count:1'> </span><span style='mso-tab-count:1'><3E><><A0><A0><A0><A0><A0> </span>Needed for building the project.</pre>

<p align=center style='margin:0in;margin-bottom:.0001pt;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";mso-fareast-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-fareast-font-family:"Courier New";
mso-bidi-font-family:"Courier New"'> <o:p></o:p></span></p>

<pre><o:p>&nbsp;</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 0in 0in 0in'>
 <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>&nbsp;</o:p></p>
  </td>
 </tr>
</table>

<pre><o:p>&nbsp;</o:p></pre><pre><o:p>&nbsp;</o:p></pre>

<p style='margin:0in;margin-bottom:.0001pt;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-fareast-font-family:
"Courier New";mso-bidi-font-family:"Courier New"'><3E> Microsoft Corporation 1999</span><span
style='font-size:10.0pt;font-family:Verdana;mso-fareast-font-family:"Courier New";
mso-bidi-font-family:"Courier New"'> <o:p></o:p></span></p>

</div>

</body>

</html>