archive
/
windows-xp
mirror of https://github.com/tongzx/nt5src
2
0
Fork 0
Code Issues Projects Releases Wiki Activity
Source code of Windows XP (NT5)
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.
6 Commits
1 Branch
0 Tags
2.0 GiB
Tree: daad8a087a
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'daad8a087a'
${ noResults }
windows-xp/Source/XPSP1/NT/drivers/ddk/wdmaudio/ac97/driver/readme.htm

251 lines
12 KiB
Raw Normal View History

Add source files
4 years ago
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
​
  1. <html xmlns:o="urn:schemas-microsoft-com:office:office"
  2. xmlns:w="urn:schemas-microsoft-com:office:word"
  3. xmlns="http://www.w3.org/TR/REC-html40">
  5. <head>
  6. <meta http-equiv=Content-Type content="text/html; charset=windows-1252">
  7. <meta name=ProgId content=FrontPage.Editor.Document>
  8. <meta name=Generator content="Microsoft FrontPage 5.0">
  9. <meta name=Originator content="Microsoft Word 10">
  10. <title>AC97</title>
  11. <!--[if gte mso 9]><xml>
  12. <w:WordDocument>
  13. <w:SpellingState>Clean</w:SpellingState>
  14. <w:BrowserLevel>MicrosoftInternetExplorer4</w:BrowserLevel>
  15. </w:WordDocument>
  16. </xml><![endif]-->
  17. <style>
  18. <!--
  19. /* Font Definitions */
  20. @font-face
  21. {font-family:Verdana;
  22. panose-1:2 11 6 4 3 5 4 4 2 4;
  23. mso-font-charset:0;
  24. mso-generic-font-family:swiss;
  25. mso-font-pitch:variable;
  26. mso-font-signature:536871559 0 0 0 415 0;}
  27. @font-face
  28. {font-family:"MS Sans Serif";
  29. panose-1:0 0 0 0 0 0 0 0 0 0;
  30. mso-font-charset:0;
  31. mso-generic-font-family:swiss;
  32. mso-font-format:other;
  33. mso-font-pitch:variable;
  34. mso-font-signature:3 0 0 0 1 0;}
  35. /* Style Definitions */
  36. p.MsoNormal, li.MsoNormal, div.MsoNormal
  37. {mso-style-parent:"";
  38. margin-bottom:.0001pt;
  39. mso-pagination:widow-orphan;
  40. font-size:12.0pt;
  41. font-family:"Times New Roman";
  42. mso-fareast-font-family:"Times New Roman"; margin-left:0in; margin-right:0in; margin-top:0in}
  43. a:link, span.MsoHyperlink
  44. {color:blue;
  45. text-decoration:underline;
  46. text-underline:single;}
  47. a:visited, span.MsoHyperlinkFollowed
  48. {color:blue;
  49. text-decoration:underline;
  50. text-underline:single;}
  51. p
  52. {mso-margin-top-alt:auto;
  53. margin-right:0in;
  54. mso-margin-bottom-alt:auto;
  55. margin-left:0in;
  56. mso-pagination:widow-orphan;
  57. font-size:12.0pt;
  58. font-family:"Times New Roman";
  59. mso-fareast-font-family:"Times New Roman";}
  60. pre
  61. {margin:0in;
  62. margin-bottom:.0001pt;
  63. mso-pagination:widow-orphan;
  64. 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;
  65. font-size:10.0pt;
  66. font-family:"Courier New";
  67. mso-fareast-font-family:"Courier New";}
  68. span.SpellE
  69. {mso-style-name:"";
  70. mso-spl-e:yes}
  71. @page Section1
  72. {size:8.5in 11.0in;
  73. margin:1.0in 1.25in 1.0in 1.25in;
  74. mso-header-margin:.5in;
  75. mso-footer-margin:.5in;
  76. mso-paper-source:0;}
  77. div.Section1
  78. {page:Section1;}
  79. -->
  80. </style>
  81. <!--[if gte mso 10]>
  82. <style>
  83. /* Style Definitions */
  84. table.MsoNormalTable
  85. {mso-style-name:"Table Normal";
  86. mso-tstyle-rowband-size:0;
  87. mso-tstyle-colband-size:0;
  88. mso-style-noshow:yes;
  89. mso-style-parent:"";
  90. mso-padding-alt:0in 5.4pt 0in 5.4pt;
  91. mso-para-margin:0in;
  92. mso-para-margin-bottom:.0001pt;
  93. mso-pagination:widow-orphan;
  94. font-size:10.0pt;
  95. font-family:"Times New Roman"}
  96. </style>
  97. <![endif]-->
  98. </head>
  100. <body lang=EN-US link=blue vlink=blue style='tab-interval:.5in'>
  102. <div class=Section1>
  104. <h2><span style='font-family:Verdana'>AC97 WDM Audio Driver Sample<o:p></o:p></span></h2>
  106. <p><span style='font-size:10.0pt;font-family:Arial;color:red'>[This is
  107. preliminary documentation and subject to change.]</span><span style='font-size:
  108. 10.0pt;font-family:Verdana'><o:p></o:p></span></p>
  110. <h3><span style='font-family:Verdana'>SUMMARY<o:p></o:p></span></h3>
  112. <p><span style='font-size:10.0pt;font-family:Verdana'>This sample driver
  113. demonstrates the basics of writing a WDM audio driver. The sample driver should
  114. work with any AC97 codec connected to an Intel� motherboard with integrated
  115. AC97 controller, like the Intel 810 Chipset. The sample driver supports multi
  116. channel audio and builds a mixer topology depending on the AC97 codec in the
  117. system.<o:p></o:p></span></p>
  119. <p><span style='font-size:10.0pt;font-family:Verdana'>Its functionality may be
  120. expanded for non-AC97 design features or to convert the driver to use a
  121. different DMA engine. For more information, please see the &quot;Driver
  122. Issues&quot; section below. <o:p></o:p></span></p>
  124. <h3><span style='font-family:Verdana'>BUILDING THE SAMPLE<o:p></o:p></span></h3>
  126. <p><span style='font-size:10.0pt;font-family:Verdana'>To build this sample,
  127. enter any Windows .NET or Windows XP build environment and run <b>build</b><b
  128. style='mso-bidi-font-weight:normal'> �<span class=SpellE>cZ</span></b> from the
  129. AC97 directory (parent directory).</span></p>
  131. <p><span style='font-size:10.0pt;font-family:Verdana'>The INF file named
  132. �AC97smpl.inf� included in the AC97 subdirectory (parent directory) can be used
  133. to install the sample driver after it has been built. Simply copy the INF and
  134. the driver binary to a floppy disk and then update the driver for the device
  135. with the one from the floppy. Note however, that the INF file tries to install
  136. the <span class=SpellE>proppage</span> sample and may want additional binaries.
  137. Please refer to the �<span class=SpellE>readme</span>� in the parent directory
  138. for more information.<o:p></o:p></span></p>
  140. <p><span style='font-size:10.0pt;font-family:Verdana'>Once the driver has been
  141. installed with the INF, the driver may be updated by copying the binary into
  142. %SystemRoot%\System32\Drivers on the target machine and rebooting to test the
  143. new driver, provided that there are no INF changes.<o:p></o:p></span></p>
  145. <h3><span style='font-family:Verdana'>DRIVER ISSUES<o:p></o:p></span></h3>
  147. <p><span style='font-size:10.0pt;font-family:Verdana'>1. At the time of
  148. writing, there is no AC97 implementation available for Alpha or IA64
  149. machines�therefore, the DDK sample source does not install on Alpha or IA64 machines.
  150. <o:p></o:p></span></p>
  152. <p><span style='font-size:10.0pt;font-family:Verdana'>2. This driver supports
  153. the old Intel 810/820/840 implementation as well as the new Intel 815/820
  154. implementation (82801BA/BAM). This new chipset supports multi channel AC97 <span
  155. class=SpellE>codecs</span>, but the sample driver will only run satisfactorily
  156. with 100% AC97 compatible <span class=SpellE>codecs</span>. The double data
  157. rate playback (96KHz, for example) feature is unsupported by those chipsets and
  158. therefore also in the driver. <o:p></o:p></span></p>
  160. <p><span style='font-size:10.0pt;font-family:Verdana'>3. The AC97 low-priority
  161. Microphone recording capability is disabled. You can record using Microphone as
  162. you would record from any other source (for example, a CD) using the normal
  163. recording selector, but the second recording line that is optionally defined in
  164. the AC97 specification is disabled. <o:p></o:p></span></p>
  166. <p><span style='font-size:10.0pt;font-family:Verdana'>4. The AC97 inputs
  167. reported to the operating system may be disabled through the INF. The INF has a
  168. section where you can disable specific input lines of the codec that are not
  169. attached to any adapters. <o:p></o:p></span></p>
  171. <p><span style='font-size:10.0pt;font-family:Verdana'>5. This driver works with
  172. Microsoft� Windows� 2000 (or later) and Microsoft Windows 98 Second Edition (or
  173. later) only. It will neither run nor install on the original release of
  174. Microsoft Windows 98. <o:p></o:p></span></p>
  176. <p><span style='font-size:10.0pt;font-family:Verdana'>6. Due to HW constrains
  177. in the Intel 440MX chipset, this driver cannot run reliably on this chipset.
  178. Therefore, please do not add PnP IDs that contain PCI\VEN_8086&amp;DEV_7195.<o:p></o:p></span></p>
  180. <h3><span lang=FR style='font-family:Verdana;mso-ansi-language:FR'>CODE TOUR<o:p></o:p></span></h3>
  182. <h4><span lang=FR style='font-family:Verdana;mso-ansi-language:FR'>File
  183. Manifest<o:p></o:p></span></h4>
  185. <pre><u><span lang=FR style='mso-ansi-language:FR'>File<span style='mso-tab-count:
  186. 2'>���������� </span>Description<o:p></o:p></span></u></pre><pre><span lang=FR
  187. style='mso-ansi-language:FR'><o:p>&nbsp;</o:p></span></pre><pre>Ac97reg.h<span style='mso-spacerun:yes'>�� </span><span
  188. style='mso-tab-count:1'>�� </span>Definition of the AC97 registers</pre><pre>Ac97smpl.inf<span
  189. style='mso-tab-count:1'>�� </span>Setup information</pre><pre>Ac97smpl.rc <span
  190. style='mso-tab-count:1'>�� </span>Resource file containing version information</pre><pre><span
  191. class=SpellE>Adapter.cpp</span> <span style='mso-tab-count:1'>�� </span>Connects driver with the system</pre><pre><span
  192. class=SpellE>Adapter.h</span><span style='mso-spacerun:yes'>�� </span><span
  193. style='mso-tab-count:1'>�� </span>Header file for <span class=SpellE>adapter.cpp</span></pre><pre><span
  194. class=SpellE>Common.cpp</span><span style='mso-spacerun:yes'>� </span><span
  195. style='mso-tab-count:1'>�� </span>Common object used by all <span class=SpellE>miniports</span></pre><pre><span
  196. class=SpellE>Common.h</span><span style='mso-spacerun:yes'>��� </span><span
  197. style='mso-tab-count:1'>�� </span>Header file for the common object</pre><pre><span
  198. class=SpellE>Debug.h</span><span style='mso-spacerun:yes'>���� </span><span
  199. style='mso-tab-count:1'>�� </span>Debug output support</pre><pre><span
  200. class=SpellE>Guids.h</span><span style='mso-spacerun:yes'>���� </span><span
  201. style='mso-tab-count:1'>�� </span>Private <span class=SpellE>GUIDs</span> used by the driver (like name definitions)</pre><pre><span
  202. class=SpellE>Ichreg.h</span><span style='mso-spacerun:yes'>��� </span><span
  203. style='mso-tab-count:1'>�� </span>Defines the registers of the INTEL AC97 interface (ICH)</pre><pre><span
  204. class=SpellE>Ichwave.cpp</span> <span style='mso-tab-count:1'>�� </span>Implementation of the stream object (DMA programming)</pre><pre><span
  205. class=SpellE>Ichwave.h</span><span style='mso-spacerun:yes'>�� </span><span
  206. style='mso-tab-count:1'>�� </span>Header file for the stream object</pre><pre><span
  207. class=SpellE>Makefile</span><span style='mso-spacerun:yes'>��� </span><span
  208. style='mso-tab-count:1'>�� </span>Standard Windows NT <span class=SpellE>makefile</span></pre><pre><span
  209. class=SpellE>Mintopo.cpp</span> <span style='mso-tab-count:1'>�� </span>Implementation of the topology miniport</pre><pre><span
  210. class=SpellE>Mintopo.h</span><span style='mso-spacerun:yes'>�� </span><span
  211. style='mso-tab-count:1'>�� </span>Header file for the topology miniport</pre><pre><span
  212. class=SpellE>Minwave.cpp</span> <span style='mso-tab-count:1'>�� </span>Implementation of the wave PCI miniport</pre><pre><span
  213. class=SpellE>Minwave.h</span><span style='mso-spacerun:yes'>�� </span><span
  214. style='mso-tab-count:1'>�� </span>Header file for the wave PCI miniport</pre><pre><span
  215. class=SpellE>Prophnd.cpp</span> <span style='mso-tab-count:1'>�� </span>Implementation of the property handler (part of the topology miniport)</pre><pre>Readme.htm<span style='mso-spacerun:yes'>� </span><span
  216. style='mso-tab-count:1'>�� </span>Documentation for this sample (this file)</pre><pre><span
  217. class=SpellE>Shared.h</span><span style='mso-spacerun:yes'>��� </span><span
  218. style='mso-tab-count:1'>�� </span>Header file shared by every C++ source file</pre><pre>Sources<span style='mso-spacerun:yes'>���� </span><span
  219. style='mso-tab-count:1'>�� </span>Dependency information for compiling</pre><pre><o:p>&nbsp;</o:p></pre>
  221. <p align=center style='margin:0in;margin-bottom:.0001pt;text-align:center;
  222. 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
  223. style='font-size:10.0pt;font-family:"Courier New";mso-fareast-font-family:"Courier New"'><a
  224. href="#top"><span style='font-family:Verdana'>Top of page</span></a></span><span
  225. style='font-size:10.0pt;font-family:Verdana;mso-fareast-font-family:"Courier New";
  226. mso-bidi-font-family:"Courier New"'> <o:p></o:p></span></p>
  228. <pre><o:p>&nbsp;</o:p></pre>
  230. <table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0 width=624
  231. style='width:6.5in;mso-cellspacing:0in;mso-padding-alt:0in 0in 0in 0in'>
  232. <tr style='mso-yfti-irow:0;mso-yfti-lastrow:yes;height:1.5pt'>
  233. <td style='background:aqua;padding:.75pt .75pt .75pt .75pt;height:1.5pt'>
  234. <p class=MsoNormal><o:p>&nbsp;</o:p></p>
  235. </td>
  236. </tr>
  237. </table>
  239. <pre><o:p>&nbsp;</o:p></pre><pre><o:p>&nbsp;</o:p></pre>
  241. <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
  242. style='font-size:7.5pt;font-family:"MS Sans Serif";mso-fareast-font-family:
  243. "Courier New";mso-bidi-font-family:"Courier New"'>� Microsoft Corporation 1999</span><span
  244. style='font-size:10.0pt;font-family:Verdana;mso-fareast-font-family:"Courier New";
  245. mso-bidi-font-family:"Courier New"'> <o:p></o:p></span></p>
  247. </div>
  249. </body>
  251. </html>