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.

270 lines
11 KiB

  1. <html xmlns:v="urn:schemas-microsoft-com:vml"
  2. xmlns:o="urn:schemas-microsoft-com:office:office"
  3. xmlns:w="urn:schemas-microsoft-com:office:word"
  4. 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>Audio Property Page Sample</title>
  11. <!--[if gte mso 9]><xml>
  12. <o:DocumentProperties>
  13. <o:Author>Frank Berreth</o:Author>
  14. <o:LastAuthor>Frank Berreth</o:LastAuthor>
  15. <o:Revision>8</o:Revision>
  16. <o:TotalTime>48</o:TotalTime>
  17. <o:Created>2001-05-10T22:12:00Z</o:Created>
  18. <o:LastSaved>2002-04-11T21:21:00Z</o:LastSaved>
  19. <o:Pages>1</o:Pages>
  20. <o:Words>469</o:Words>
  21. <o:Characters>2676</o:Characters>
  22. <o:Company>Microsoft Corp.</o:Company>
  23. <o:Lines>22</o:Lines>
  24. <o:Paragraphs>6</o:Paragraphs>
  25. <o:CharactersWithSpaces>3139</o:CharactersWithSpaces>
  26. <o:Version>10.3311</o:Version>
  27. </o:DocumentProperties>
  28. </xml><![endif]--><!--[if gte mso 9]><xml>
  29. <w:WordDocument>
  30. <w:BrowserLevel>MicrosoftInternetExplorer4</w:BrowserLevel>
  31. </w:WordDocument>
  32. </xml><![endif]-->
  33. <style>
  34. <!--
  35. /* Font Definitions */
  36. @font-face
  37. {font-family:Verdana;
  38. panose-1:2 11 6 4 3 5 4 4 2 4;
  39. mso-font-charset:0;
  40. mso-generic-font-family:swiss;
  41. mso-font-pitch:variable;
  42. mso-font-signature:536871559 0 0 0 415 0;}
  43. @font-face
  44. {font-family:"MS Sans Serif";
  45. panose-1:0 0 0 0 0 0 0 0 0 0;
  46. mso-font-charset:0;
  47. mso-generic-font-family:swiss;
  48. mso-font-format:other;
  49. mso-font-pitch:auto;
  50. mso-font-signature:3 0 0 0 1 0;}
  51. /* Style Definitions */
  52. p.MsoNormal, li.MsoNormal, div.MsoNormal
  53. {mso-style-parent:"";
  54. margin-bottom:.0001pt;
  55. mso-pagination:widow-orphan;
  56. font-size:12.0pt;
  57. font-family:"Times New Roman";
  58. mso-fareast-font-family:"Times New Roman"; margin-left:0in; margin-right:0in; margin-top:0in}
  59. h2
  60. {mso-margin-top-alt:auto;
  61. margin-right:0in;
  62. mso-margin-bottom-alt:auto;
  63. margin-left:0in;
  64. mso-pagination:widow-orphan;
  65. mso-outline-level:2;
  66. font-size:18.0pt;
  67. font-family:"Times New Roman";
  68. font-weight:bold;}
  69. h3
  70. {mso-margin-top-alt:auto;
  71. margin-right:0in;
  72. mso-margin-bottom-alt:auto;
  73. margin-left:0in;
  74. mso-pagination:widow-orphan;
  75. mso-outline-level:3;
  76. font-size:13.5pt;
  77. font-family:"Times New Roman";
  78. font-weight:bold;}
  79. h4
  80. {mso-margin-top-alt:auto;
  81. margin-right:0in;
  82. mso-margin-bottom-alt:auto;
  83. margin-left:0in;
  84. mso-pagination:widow-orphan;
  85. mso-outline-level:4;
  86. font-size:12.0pt;
  87. font-family:"Times New Roman";
  88. font-weight:bold;}
  89. a:link, span.MsoHyperlink
  90. {color:blue;
  91. text-decoration:underline;
  92. text-underline:single;}
  93. a:visited, span.MsoHyperlinkFollowed
  94. {color:purple;
  95. text-decoration:underline;
  96. text-underline:single;}
  97. p
  98. {mso-margin-top-alt:auto;
  99. margin-right:0in;
  100. mso-margin-bottom-alt:auto;
  101. margin-left:0in;
  102. mso-pagination:widow-orphan;
  103. font-size:12.0pt;
  104. font-family:"Times New Roman";
  105. mso-fareast-font-family:"Times New Roman";}
  106. pre
  107. {margin:0in;
  108. margin-bottom:.0001pt;
  109. mso-pagination:widow-orphan;
  110. 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;
  111. font-size:10.0pt;
  112. font-family:"Courier New";
  113. mso-fareast-font-family:"Courier New";}
  114. @page Section1
  115. {size:8.5in 11.0in;
  116. margin:1.0in 1.25in 1.0in 1.25in;
  117. mso-header-margin:.5in;
  118. mso-footer-margin:.5in;
  119. mso-paper-source:0;}
  120. div.Section1
  121. {page:Section1;}
  122. -->
  123. </style>
  124. <!--[if gte mso 10]>
  125. <style>
  126. /* Style Definitions */
  127. table.MsoNormalTable
  128. {mso-style-name:"Table Normal";
  129. mso-tstyle-rowband-size:0;
  130. mso-tstyle-colband-size:0;
  131. mso-style-noshow:yes;
  132. mso-style-parent:"";
  133. mso-padding-alt:0in 5.4pt 0in 5.4pt;
  134. mso-para-margin:0in;
  135. mso-para-margin-bottom:.0001pt;
  136. mso-pagination:widow-orphan;
  137. font-size:10.0pt;
  138. font-family:"Times New Roman"}
  139. </style>
  140. <![endif]-->
  141. </head>
  142. <body lang=EN-US link=blue vlink=purple style='tab-interval:.5in'>
  143. <div class=Section1>
  144. <h2><span style='font-family:Verdana'>Audio Control Panel Applet Sample<o:p></o:p></span></h2>
  145. <p><span style='font-size:10.0pt;font-family:Arial;color:red'>[This is
  146. preliminary documentation and subject to change.]</span><span style='font-size:
  147. 10.0pt;font-family:Verdana'><o:p></o:p></span></p>
  148. <h3><span style='font-family:Verdana'>SUMMARY<o:p></o:p></span></h3>
  149. <p><span style='font-size:10.0pt;font-family:Verdana'>This sample demonstrates
  150. the basics of writing a control panel applet. The sample only works in
  151. conjunction with the AC97 property page sample which in turn requires the AC97
  152. WDM audio driver sample. The AC97 WDM audio driver sample runs on an Intel�
  153. motherboard with integrated AC97 controller, like the Intel 810 Chipset.<o:p></o:p></span></p>
  154. <p><span lang=EN-GB style='font-size:10.0pt;font-family:Verdana;mso-ansi-language:
  155. EN-GB'>Microsoft discourages the use of control panel applets since cluttering
  156. of the control panel is confusing to most users. </span><span style='font-size:
  157. 10.0pt;font-family:Verdana'>Most of the functionality that you might want to
  158. provide can be added in a property sheet that is added to the property page of
  159. your device. See the proppage sample for how to write a property page DLL.<o:p></o:p></span></p>
  160. <p><span style='font-size:10.0pt;font-family:Verdana'>Microsoft also discourages
  161. the use of system tray programs (programs that get displayed in the
  162. notification area of the system tray). These programs are running all the time
  163. and eat up resources. The notification area of the system tray is for notifying
  164. the user of events only.<o:p></o:p></span></p>
  165. <p><span style='font-size:10.0pt;font-family:Verdana'>In case you find you
  166. can�t get all the functionality or configuration options you need into the
  167. property page of your device driver, this sample shows you how to write a
  168. control panel applet that might provide more extensive configuration options
  169. and/or functionality.<o:p></o:p></span></p>
  170. <h3><span style='font-family:Verdana'>BUILDING THE SAMPLE<o:p></o:p></span></h3>
  171. <p><span style='font-size:10.0pt;font-family:Verdana'>To build this sample,
  172. enter any Windows .NET or Windows XP build environment and run <b>build</b><b
  173. style='mso-bidi-font-weight:normal'> �cZ</b> from the AC97 directory (parent
  174. directory). This would also compile the AC97 WDM audio
  175. driver sample and the property page sample that is needed for this sample to
  176. work.<o:p></o:p></span></p>
  177. <p><span style='font-size:10.0pt;font-family:Verdana'>The INF named
  178. �AC97smpl.inf� included in the AC97 subdirectory (parent directory) can be used
  179. to install the AC97 property page sample and the AC97 WDM audio driver sample
  180. that is needed for this sample. Simply copy the INF and the AC97 driver binary
  181. and the property page sample binary to a floppy disk and then update the driver
  182. for the device with the one from the floppy. After updating the driver, the
  183. control panel applet can be installed by simply copying the binary to the
  184. %SystemRoot%\System32 directory.<o:p></o:p></span></p>
  185. <h3><span style='font-family:Verdana'>SAMPLE ISSUES<o:p></o:p></span></h3>
  186. <h3><span style='font-size:10.0pt;mso-bidi-font-size:13.5pt;font-family:Verdana;
  187. font-weight:normal'>This sample only works with </span><span style='font-size:
  188. 10.0pt;font-family:Verdana;font-weight:normal'>Microsoft� Windows� 2000 (or
  189. higher)</span><span style='font-size:10.0pt;font-family:Verdana'> </span><span
  190. style='font-size:10.0pt;font-family:Verdana;font-weight:normal'>operating
  191. system due to the restrictions of the AC97 property page sample.</span><span
  192. style='font-size:10.0pt;mso-bidi-font-size:13.5pt;font-family:Verdana;
  193. font-weight:normal'><o:p></o:p></span></h3>
  194. <p><b><span style='font-size:13.5pt;mso-bidi-font-size:12.0pt;font-family:Verdana'>ADDITIONAL
  195. INFORMATION TO THE SAMPLE<o:p></o:p></span></b></p>
  196. <p><span style='font-size:10.0pt;mso-bidi-font-size:12.0pt;font-family:Verdana'>This
  197. control panel applet simply creates a dialog and loads the AC97 property page
  198. sample that in turn provides a property sheet to this dialog. The control panel
  199. applet then displays the dialog. The interesting part in this sample is to find
  200. the AC97 WDM audio driver sample in the system since this information needs to
  201. be passed to the AC97 property page sample.<o:p></o:p></span></p>
  202. <h3><span lang=FR style='font-family:Verdana;mso-ansi-language:FR'>CODE TOUR<o:p></o:p></span></h3>
  203. <h4><span lang=FR style='font-family:Verdana;mso-ansi-language:FR'>File
  204. Manifest<o:p></o:p></span></h4>
  205. <pre><u><span lang=FR style='mso-ansi-language:FR'>File<span style='mso-tab-count:
  206. 2'>���������� </span>Description<o:p></o:p></span></u></pre><pre><span lang=FR
  207. style='mso-ansi-language:FR'><o:p>&nbsp;</o:p></span></pre><pre>Ac97cpl.cpp<span
  208. style='mso-tab-count:1'>��� </span>Includes all the code necessary for the sample</pre><pre>Ac97cpl.def<span
  209. style='mso-tab-count:1'>��� </span>To build the CPL</pre><pre>Ac97cpl.ico<span
  210. style='mso-tab-count:1'>��� </span>The icon</pre><pre>Ac97cpl.rc<span
  211. style='mso-tab-count:1'>���� </span>Property sheet definition</pre><pre>Makefile<span
  212. style='mso-tab-count:1'>������ </span>Standard Windows NT makefile</pre><pre>Readme.htm<span
  213. style='mso-tab-count:1'>���� </span>This file</pre><pre>Sources<span
  214. style='mso-tab-count:2'>������� </span>Dependency information for compiling</pre><pre>Version.h<span
  215. style='mso-tab-count:1'>����� </span>Version information</pre><pre><o:p>&nbsp;</o:p></pre>
  216. <p align=center style='margin:0in;margin-bottom:.0001pt;text-align:center;
  217. 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
  218. style='font-size:10.0pt;font-family:"Courier New";mso-fareast-font-family:"Courier New"'><a
  219. href="../../../../../../../../NTdriverswdmaudiobackplnadaptersintelproppage%22%20l"><span
  220. style='font-family:Verdana'>Top of page</span></a></span><span
  221. style='font-size:10.0pt;font-family:Verdana;mso-fareast-font-family:"Courier New";
  222. mso-bidi-font-family:"Courier New"'> <o:p></o:p></span></p>
  223. <pre><o:p>&nbsp;</o:p></pre>
  224. <table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0 width=624
  225. style='width:6.5in;mso-cellspacing:0in;mso-padding-alt:0in 0in 0in 0in'>
  226. <tr style='mso-yfti-irow:0;mso-yfti-lastrow:yes;height:1.5pt'>
  227. <td style='background:aqua;padding:.75pt .75pt .75pt .75pt;height:1.5pt'>
  228. <p class=MsoNormal><o:p>&nbsp;</o:p></p>
  229. </td>
  230. </tr>
  231. </table>
  232. <pre><o:p>&nbsp;</o:p></pre><pre><o:p>&nbsp;</o:p></pre>
  233. <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
  234. style='font-size:7.5pt;font-family:"MS Sans Serif";mso-fareast-font-family:
  235. "Courier New";mso-bidi-font-family:"Courier New"'>� Microsoft Corporation 1999</span><span
  236. style='font-size:10.0pt;font-family:Verdana;mso-fareast-font-family:"Courier New";
  237. mso-bidi-font-family:"Courier New"'> <o:p></o:p></span></p>
  238. <p class=MsoNormal 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'><o:p>&nbsp;</o:p></p>
  239. </div>
  240. </body>
  241. </html>