Leaked source code of windows server 2003
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.

228 lines
10 KiB

  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">
  4. <head>
  5. <meta http-equiv=Content-Type content="text/html; charset=windows-1252">
  6. <meta name=ProgId content=Word.Document>
  7. <meta name=Generator content="Microsoft Word 9">
  8. <meta name=Originator content="Microsoft Word 9">
  9. <link rel=File-List href="./readme_files/filelist.xml">
  10. <title>WMI ACPI Mapper</title>
  11. <!--[if gte mso 9]><xml>
  12. <o:DocumentProperties>
  13. <o:LastAuthor>Alan Warwick</o:LastAuthor>
  14. <o:Revision>3</o:Revision>
  15. <o:TotalTime>1</o:TotalTime>
  16. <o:Created>2001-02-09T22:24:00Z</o:Created>
  17. <o:LastSaved>2001-02-09T22:26:00Z</o:LastSaved>
  18. <o:Pages>1</o:Pages>
  19. <o:Words>324</o:Words>
  20. <o:Characters>1852</o:Characters>
  21. <o:Company>Microsoft Internal</o:Company>
  22. <o:Lines>15</o:Lines>
  23. <o:Paragraphs>3</o:Paragraphs>
  24. <o:CharactersWithSpaces>2274</o:CharactersWithSpaces>
  25. <o:Version>9.3821</o:Version>
  26. </o:DocumentProperties>
  27. </xml><![endif]-->
  28. <style>
  29. <!--
  30. /* Font Definitions */
  31. @font-face
  32. {font-family:"MS Mincho";
  33. panose-1:2 2 6 9 4 2 5 8 3 4;
  34. mso-font-alt:"\FF2D\FF33 \660E\671D";
  35. mso-font-charset:128;
  36. mso-generic-font-family:modern;
  37. mso-font-pitch:fixed;
  38. mso-font-signature:-1610612033 1757936891 16 0 131231 0;}
  39. @font-face
  40. {font-family:"\@MS Mincho";
  41. panose-1:2 2 6 9 4 2 5 8 3 4;
  42. mso-font-charset:128;
  43. mso-generic-font-family:modern;
  44. mso-font-pitch:fixed;
  45. mso-font-signature:-1610612033 1757936891 16 0 131231 0;}
  46. /* Style Definitions */
  47. p.MsoNormal, li.MsoNormal, div.MsoNormal
  48. {mso-style-parent:"";
  49. margin:0in;
  50. margin-bottom:.0001pt;
  51. mso-pagination:widow-orphan;
  52. font-size:12.0pt;
  53. font-family:"Times New Roman";
  54. mso-fareast-font-family:"Times New Roman";}
  55. p.MsoPlainText, li.MsoPlainText, div.MsoPlainText
  56. {margin:0in;
  57. margin-bottom:.0001pt;
  58. mso-pagination:widow-orphan;
  59. font-size:10.0pt;
  60. font-family:"Courier New";
  61. mso-fareast-font-family:"Times New Roman";}
  62. @page Section1
  63. {size:8.5in 11.0in;
  64. margin:1.0in 65.95pt 1.0in 65.95pt;
  65. mso-header-margin:.5in;
  66. mso-footer-margin:.5in;
  67. mso-paper-source:0;}
  68. div.Section1
  69. {page:Section1;}
  70. -->
  71. </style>
  72. </head>
  73. <body lang=EN-US style='tab-interval:.5in'>
  74. <div class=Section1>
  75. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'>This
  76. directory contains files that allow an ACPI bios developer to add <o:p></o:p></span></p>
  77. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'>instrumentation
  78. from within ASL code. ASL code can expose data blocks, methods<o:p></o:p></span></p>
  79. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'>and
  80. events via WMI by leveraging the WMIACPI.SYS driver. More information<o:p></o:p></span></p>
  81. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'>about the
  82. mechanics of writing ASL to expose instrumentation information is<o:p></o:p></span></p>
  83. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'>available
  84. in wmi-acpi.doc or on <o:p></o:p></span></p>
  85. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'>http://www.microsoft.com/HWDev/MANAGEABILITY/wmi-acpi.htm.<o:p></o:p></span></p>
  86. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></span></p>
  87. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></span></p>
  88. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'>Device.ASL
  89. - ASL code that can be included in the acpi bios that exposes <o:p></o:p></span></p>
  90. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'><span
  91. style="mso-spacerun: yes">������������ </span>a set of packages, strings, data,
  92. methods and events.<o:p></o:p></span></p>
  93. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></span></p>
  94. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'>acpimof.mof
  95. - Managed Object Format file that contains a description<span
  96. style="mso-spacerun: yes">� </span>of the <o:p></o:p></span></p>
  97. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'><span
  98. style="mso-spacerun: yes">������������� </span>data blocks, methods and events
  99. exposed. This description is<o:p></o:p></span></p>
  100. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'><span
  101. style="mso-spacerun: yes">������������� </span>required so that WMI is able to
  102. access the data blocks, methods<o:p></o:p></span></p>
  103. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'><span
  104. style="mso-spacerun: yes">������������� </span>and events.<o:p></o:p></span></p>
  105. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></span></p>
  106. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'>acpimof.rc,
  107. acpimof.def - FIles required to build acpimof.dll, a resource only<o:p></o:p></span></p>
  108. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'><span
  109. style="mso-spacerun: yes">������������� </span>dll.<o:p></o:p></span></p>
  110. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></span></p>
  111. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'>makefile,
  112. sources, makefile.inc - build glue<o:p></o:p></span></p>
  113. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></span></p>
  114. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'>wmi-acpi.doc
  115. - White paper describing how to add instrumentation to ASL code.<o:p></o:p></span></p>
  116. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></span></p>
  117. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'>acpimof.vbs
  118. - Built at the same time as acpimof.dll, this file contains a<o:p></o:p></span></p>
  119. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'><span
  120. style="mso-spacerun: yes">������������� </span>VBScript applet that will query
  121. all classes specified in the<o:p></o:p></span></p>
  122. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'><span
  123. style="mso-spacerun: yes">������������� </span>acpimof.mof file.<o:p></o:p></span></p>
  124. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></span></p>
  125. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></span></p>
  126. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'>To add
  127. the sample code to your acpi bios and access via WMI:<o:p></o:p></span></p>
  128. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></span></p>
  129. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'>1.
  130. Include the contents of device.asl to your asl source and rebuild the<o:p></o:p></span></p>
  131. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'><span
  132. style="mso-spacerun: yes">�� </span>DSDT. Update the OS with the new dsdt via
  133. the registry or reflashing.<o:p></o:p></span></p>
  134. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></span></p>
  135. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'>2.
  136. Build acpimof.dll in this directory. acpimof.dll is a resource only dll<o:p></o:p></span></p>
  137. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'><span
  138. style="mso-spacerun: yes">�� </span>that contains the compiled mof in a form
  139. that WMI can import into its<o:p></o:p></span></p>
  140. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'><span
  141. style="mso-spacerun: yes">�� </span>schema.<o:p></o:p></span></p>
  142. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></span></p>
  143. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'>3. Copy
  144. acpimof.dll to %windir%\system32 and add a value named &quot;MofImagePath&quot;<o:p></o:p></span></p>
  145. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'><span
  146. style="mso-spacerun: yes">�� </span>under the
  147. HKEY_LOCAL_MACHINE\CurrentControlSet\Services\WmiAcpi key. The<o:p></o:p></span></p>
  148. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'><span
  149. style="mso-spacerun: yes">�� </span>contents of the value should be a path to
  150. the acpimof.dll file.<o:p></o:p></span></p>
  151. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></span></p>
  152. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'>4.
  153. Reboot. When PNP recognizes the new device with a pnpid of pnp0c14<o:p></o:p></span></p>
  154. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'><span
  155. style="mso-spacerun: yes">�� </span>it will install wmiacpi.sys automatically
  156. and make the mof resource<o:p></o:p></span></p>
  157. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'><span
  158. style="mso-spacerun: yes">�� </span>in acpimof.dll available to the WMI schema.<o:p></o:p></span></p>
  159. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></span></p>
  160. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'>5.
  161. Execute the acpimof.vbs test by entering acpimof.vbs at the command line<o:p></o:p></span></p>
  162. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'><span
  163. style="mso-spacerun: yes">�� </span>and reviewing the acpitest.log to insure
  164. that all data returned is correct.<o:p></o:p></span></p>
  165. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></span></p>
  166. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'><![if !supportEmptyParas]>&nbsp;<![endif]><o:p></o:p></span></p>
  167. <p class=MsoPlainText><span style='mso-fareast-font-family:"MS Mincho"'>Note
  168. that no INF file is needed since Windows supplies an INF for the ACPI mapper
  169. device as part of Windows<o:p></o:p></span></p>
  170. </div>
  171. </body>
  172. </html>