diff options
| author | Barry Golden <[email protected]> | 2015-08-06 20:06:07 -0700 |
|---|---|---|
| committer | Barry Golden <[email protected]> | 2015-08-06 20:06:07 -0700 |
| commit | 9026073a419b5ef68fb46d4f7fae52dbef09dbe1 (patch) | |
| tree | b81f73f650af9ac82a7e8739e989456f6e192b37 /general | |
| parent | bd17fd844b4f074821b9d4c7bc86b9dc7f0e4a59 (diff) | |
Remove obsolete readme.htm files
Diffstat (limited to 'general')
| -rw-r--r-- | general/SystemDma/wdm/systemdma.htm | 741 | ||||
| -rw-r--r-- | general/cancel/cancel.htm | 302 | ||||
| -rw-r--r-- | general/event/event.htm | 229 | ||||
| -rw-r--r-- | general/ioctl/wdm/ioctl.htm | 742 | ||||
| -rw-r--r-- | general/perfcounters/kcs/kcs.htm | 757 | ||||
| -rw-r--r-- | general/toaster/toastpkg/toastpkg.htm | 186 | ||||
| -rw-r--r-- | general/tracing/evntdrv/evntdrv.htm | 189 | ||||
| -rw-r--r-- | general/tracing/tracedriver/tracedrv.htm | 1052 |
8 files changed, 0 insertions, 4198 deletions
diff --git a/general/SystemDma/wdm/systemdma.htm b/general/SystemDma/wdm/systemdma.htm deleted file mode 100644 index 301dead7..00000000 --- a/general/SystemDma/wdm/systemdma.htm +++ /dev/null @@ -1,741 +0,0 @@ -<html xmlns:v="urn:schemas-microsoft-com:vml" -xmlns:o="urn:schemas-microsoft-com:office:office" -xmlns:w="urn:schemas-microsoft-com:office:word" -xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" -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 12"> -<meta name=Originator content="Microsoft Word 12"> -<link rel=File-List href="sdma_files/filelist.xml"> -<!--[if gte mso 9]><xml> - <o:OfficeDocumentSettings> - <o:RemovePersonalInformation/> - <o:RemoveDateAndTime/> - </o:OfficeDocumentSettings> -</xml><![endif]--> -<link rel=themeData href="sdma_files/themedata.thmx"> -<link rel=colorSchemeMapping href="sdma_files/colorschememapping.xml"> -<!--[if gte mso 9]><xml> - <w:WordDocument> - <w:TrackMoves>false</w:TrackMoves> - <w:TrackFormatting/> - <w:ValidateAgainstSchemas/> - <w:SaveIfXMLInvalid>false</w:SaveIfXMLInvalid> - <w:IgnoreMixedContent>false</w:IgnoreMixedContent> - <w:AlwaysShowPlaceholderText>false</w:AlwaysShowPlaceholderText> - <w:DoNotPromoteQF/> - <w:LidThemeOther>EN-US</w:LidThemeOther> - <w:LidThemeAsian>X-NONE</w:LidThemeAsian> - <w:LidThemeComplexScript>X-NONE</w:LidThemeComplexScript> - <w:Compatibility> - <w:BreakWrappedTables/> - <w:SnapToGridInCell/> - <w:WrapTextWithPunct/> - <w:UseAsianBreakRules/> - <w:DontGrowAutofit/> - <w:SplitPgBreakAndParaMark/> - <w:DontVertAlignCellWithSp/> - <w:DontBreakConstrainedForcedTables/> - <w:DontVertAlignInTxbx/> - <w:Word11KerningPairs/> - <w:CachedColBalance/> - </w:Compatibility> - <w:BrowserLevel>MicrosoftInternetExplorer4</w:BrowserLevel> - <m:mathPr> - <m:mathFont m:val="Cambria Math"/> - <m:brkBin m:val="before"/> - <m:brkBinSub m:val="--"/> - <m:smallFrac m:val="off"/> - <m:dispDef/> - <m:lMargin m:val="0"/> - <m:rMargin m:val="0"/> - <m:defJc m:val="centerGroup"/> - <m:wrapIndent m:val="1440"/> - <m:intLim m:val="subSup"/> - <m:naryLim m:val="undOvr"/> - </m:mathPr></w:WordDocument> -</xml><![endif]--><!--[if gte mso 9]><xml> - <w:LatentStyles DefLockedState="false" DefUnhideWhenUsed="true" - DefSemiHidden="true" DefQFormat="false" DefPriority="99" - LatentStyleCount="267"> - <w:LsdException Locked="false" Priority="0" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Normal"/> - <w:LsdException Locked="false" Priority="9" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="heading 1"/> - <w:LsdException Locked="false" Priority="9" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="heading 2"/> - <w:LsdException Locked="false" Priority="9" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="heading 3"/> - <w:LsdException Locked="false" Priority="9" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="heading 4"/> - <w:LsdException Locked="false" Priority="9" QFormat="true" Name="heading 5"/> - <w:LsdException Locked="false" Priority="9" QFormat="true" Name="heading 6"/> - <w:LsdException Locked="false" Priority="9" QFormat="true" Name="heading 7"/> - <w:LsdException Locked="false" Priority="9" QFormat="true" Name="heading 8"/> - <w:LsdException Locked="false" Priority="9" QFormat="true" Name="heading 9"/> - <w:LsdException Locked="false" Priority="39" Name="toc 1"/> - <w:LsdException Locked="false" Priority="39" Name="toc 2"/> - <w:LsdException Locked="false" Priority="39" Name="toc 3"/> - <w:LsdException Locked="false" Priority="39" Name="toc 4"/> - <w:LsdException Locked="false" Priority="39" Name="toc 5"/> - <w:LsdException Locked="false" Priority="39" Name="toc 6"/> - <w:LsdException Locked="false" Priority="39" Name="toc 7"/> - <w:LsdException Locked="false" Priority="39" Name="toc 8"/> - <w:LsdException Locked="false" Priority="39" Name="toc 9"/> - <w:LsdException Locked="false" Priority="35" QFormat="true" Name="caption"/> - <w:LsdException Locked="false" Priority="10" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Title"/> - <w:LsdException Locked="false" Priority="1" Name="Default Paragraph Font"/> - <w:LsdException Locked="false" Priority="11" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Subtitle"/> - <w:LsdException Locked="false" Priority="22" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Strong"/> - <w:LsdException Locked="false" Priority="20" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Emphasis"/> - <w:LsdException Locked="false" Priority="59" SemiHidden="false" - UnhideWhenUsed="false" Name="Table Grid"/> - <w:LsdException Locked="false" UnhideWhenUsed="false" Name="Placeholder Text"/> - <w:LsdException Locked="false" Priority="1" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="No Spacing"/> - <w:LsdException Locked="false" Priority="60" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Shading"/> - <w:LsdException Locked="false" Priority="61" SemiHidden="false" - UnhideWhenUsed="false" Name="Light List"/> - <w:LsdException Locked="false" Priority="62" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Grid"/> - <w:LsdException Locked="false" Priority="63" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 1"/> - <w:LsdException Locked="false" Priority="64" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 2"/> - <w:LsdException Locked="false" Priority="65" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 1"/> - <w:LsdException Locked="false" Priority="66" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 2"/> - <w:LsdException Locked="false" Priority="67" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 1"/> - <w:LsdException Locked="false" Priority="68" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 2"/> - <w:LsdException Locked="false" Priority="69" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 3"/> - <w:LsdException Locked="false" Priority="70" SemiHidden="false" - UnhideWhenUsed="false" Name="Dark List"/> - <w:LsdException Locked="false" Priority="71" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Shading"/> - <w:LsdException Locked="false" Priority="72" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful List"/> - <w:LsdException Locked="false" Priority="73" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Grid"/> - <w:LsdException Locked="false" Priority="60" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Shading Accent 1"/> - <w:LsdException Locked="false" Priority="61" SemiHidden="false" - UnhideWhenUsed="false" Name="Light List Accent 1"/> - <w:LsdException Locked="false" Priority="62" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Grid Accent 1"/> - <w:LsdException Locked="false" Priority="63" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 1 Accent 1"/> - <w:LsdException Locked="false" Priority="64" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 2 Accent 1"/> - <w:LsdException Locked="false" Priority="65" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 1 Accent 1"/> - <w:LsdException Locked="false" UnhideWhenUsed="false" Name="Revision"/> - <w:LsdException Locked="false" Priority="34" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="List Paragraph"/> - <w:LsdException Locked="false" Priority="29" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Quote"/> - <w:LsdException Locked="false" Priority="30" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Intense Quote"/> - <w:LsdException Locked="false" Priority="66" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 2 Accent 1"/> - <w:LsdException Locked="false" Priority="67" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 1 Accent 1"/> - <w:LsdException Locked="false" Priority="68" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 2 Accent 1"/> - <w:LsdException Locked="false" Priority="69" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 3 Accent 1"/> - <w:LsdException Locked="false" Priority="70" SemiHidden="false" - UnhideWhenUsed="false" Name="Dark List Accent 1"/> - <w:LsdException Locked="false" Priority="71" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Shading Accent 1"/> - <w:LsdException Locked="false" Priority="72" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful List Accent 1"/> - <w:LsdException Locked="false" Priority="73" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Grid Accent 1"/> - <w:LsdException Locked="false" Priority="60" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Shading Accent 2"/> - <w:LsdException Locked="false" Priority="61" SemiHidden="false" - UnhideWhenUsed="false" Name="Light List Accent 2"/> - <w:LsdException Locked="false" Priority="62" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Grid Accent 2"/> - <w:LsdException Locked="false" Priority="63" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 1 Accent 2"/> - <w:LsdException Locked="false" Priority="64" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 2 Accent 2"/> - <w:LsdException Locked="false" Priority="65" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 1 Accent 2"/> - <w:LsdException Locked="false" Priority="66" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 2 Accent 2"/> - <w:LsdException Locked="false" Priority="67" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 1 Accent 2"/> - <w:LsdException Locked="false" Priority="68" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 2 Accent 2"/> - <w:LsdException Locked="false" Priority="69" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 3 Accent 2"/> - <w:LsdException Locked="false" Priority="70" SemiHidden="false" - UnhideWhenUsed="false" Name="Dark List Accent 2"/> - <w:LsdException Locked="false" Priority="71" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Shading Accent 2"/> - <w:LsdException Locked="false" Priority="72" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful List Accent 2"/> - <w:LsdException Locked="false" Priority="73" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Grid Accent 2"/> - <w:LsdException Locked="false" Priority="60" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Shading Accent 3"/> - <w:LsdException Locked="false" Priority="61" SemiHidden="false" - UnhideWhenUsed="false" Name="Light List Accent 3"/> - <w:LsdException Locked="false" Priority="62" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Grid Accent 3"/> - <w:LsdException Locked="false" Priority="63" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 1 Accent 3"/> - <w:LsdException Locked="false" Priority="64" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 2 Accent 3"/> - <w:LsdException Locked="false" Priority="65" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 1 Accent 3"/> - <w:LsdException Locked="false" Priority="66" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 2 Accent 3"/> - <w:LsdException Locked="false" Priority="67" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 1 Accent 3"/> - <w:LsdException Locked="false" Priority="68" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 2 Accent 3"/> - <w:LsdException Locked="false" Priority="69" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 3 Accent 3"/> - <w:LsdException Locked="false" Priority="70" SemiHidden="false" - UnhideWhenUsed="false" Name="Dark List Accent 3"/> - <w:LsdException Locked="false" Priority="71" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Shading Accent 3"/> - <w:LsdException Locked="false" Priority="72" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful List Accent 3"/> - <w:LsdException Locked="false" Priority="73" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Grid Accent 3"/> - <w:LsdException Locked="false" Priority="60" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Shading Accent 4"/> - <w:LsdException Locked="false" Priority="61" SemiHidden="false" - UnhideWhenUsed="false" Name="Light List Accent 4"/> - <w:LsdException Locked="false" Priority="62" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Grid Accent 4"/> - <w:LsdException Locked="false" Priority="63" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 1 Accent 4"/> - <w:LsdException Locked="false" Priority="64" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 2 Accent 4"/> - <w:LsdException Locked="false" Priority="65" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 1 Accent 4"/> - <w:LsdException Locked="false" Priority="66" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 2 Accent 4"/> - <w:LsdException Locked="false" Priority="67" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 1 Accent 4"/> - <w:LsdException Locked="false" Priority="68" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 2 Accent 4"/> - <w:LsdException Locked="false" Priority="69" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 3 Accent 4"/> - <w:LsdException Locked="false" Priority="70" SemiHidden="false" - UnhideWhenUsed="false" Name="Dark List Accent 4"/> - <w:LsdException Locked="false" Priority="71" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Shading Accent 4"/> - <w:LsdException Locked="false" Priority="72" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful List Accent 4"/> - <w:LsdException Locked="false" Priority="73" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Grid Accent 4"/> - <w:LsdException Locked="false" Priority="60" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Shading Accent 5"/> - <w:LsdException Locked="false" Priority="61" SemiHidden="false" - UnhideWhenUsed="false" Name="Light List Accent 5"/> - <w:LsdException Locked="false" Priority="62" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Grid Accent 5"/> - <w:LsdException Locked="false" Priority="63" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 1 Accent 5"/> - <w:LsdException Locked="false" Priority="64" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 2 Accent 5"/> - <w:LsdException Locked="false" Priority="65" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 1 Accent 5"/> - <w:LsdException Locked="false" Priority="66" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 2 Accent 5"/> - <w:LsdException Locked="false" Priority="67" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 1 Accent 5"/> - <w:LsdException Locked="false" Priority="68" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 2 Accent 5"/> - <w:LsdException Locked="false" Priority="69" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 3 Accent 5"/> - <w:LsdException Locked="false" Priority="70" SemiHidden="false" - UnhideWhenUsed="false" Name="Dark List Accent 5"/> - <w:LsdException Locked="false" Priority="71" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Shading Accent 5"/> - <w:LsdException Locked="false" Priority="72" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful List Accent 5"/> - <w:LsdException Locked="false" Priority="73" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Grid Accent 5"/> - <w:LsdException Locked="false" Priority="60" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Shading Accent 6"/> - <w:LsdException Locked="false" Priority="61" SemiHidden="false" - UnhideWhenUsed="false" Name="Light List Accent 6"/> - <w:LsdException Locked="false" Priority="62" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Grid Accent 6"/> - <w:LsdException Locked="false" Priority="63" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 1 Accent 6"/> - <w:LsdException Locked="false" Priority="64" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 2 Accent 6"/> - <w:LsdException Locked="false" Priority="65" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 1 Accent 6"/> - <w:LsdException Locked="false" Priority="66" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 2 Accent 6"/> - <w:LsdException Locked="false" Priority="67" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 1 Accent 6"/> - <w:LsdException Locked="false" Priority="68" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 2 Accent 6"/> - <w:LsdException Locked="false" Priority="69" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 3 Accent 6"/> - <w:LsdException Locked="false" Priority="70" SemiHidden="false" - UnhideWhenUsed="false" Name="Dark List Accent 6"/> - <w:LsdException Locked="false" Priority="71" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Shading Accent 6"/> - <w:LsdException Locked="false" Priority="72" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful List Accent 6"/> - <w:LsdException Locked="false" Priority="73" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Grid Accent 6"/> - <w:LsdException Locked="false" Priority="19" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Subtle Emphasis"/> - <w:LsdException Locked="false" Priority="21" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Intense Emphasis"/> - <w:LsdException Locked="false" Priority="31" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Subtle Reference"/> - <w:LsdException Locked="false" Priority="32" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Intense Reference"/> - <w:LsdException Locked="false" Priority="33" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Book Title"/> - <w:LsdException Locked="false" Priority="37" Name="Bibliography"/> - <w:LsdException Locked="false" Priority="39" QFormat="true" Name="TOC Heading"/> - </w:LatentStyles> -</xml><![endif]--> -<style> -<!-- - /* Font Definitions */ - @font-face - {font-family:"Cambria Math"; - panose-1:2 4 5 3 5 4 6 3 2 4; - mso-font-charset:0; - mso-generic-font-family:roman; - mso-font-pitch:variable; - mso-font-signature:-1610611985 1107304683 0 0 159 0;} -@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:-1593833729 1073750107 16 0 415 0;} -@font-face - {font-family:Consolas; - panose-1:2 11 6 9 2 2 4 3 2 4; - mso-font-charset:0; - mso-generic-font-family:modern; - mso-font-pitch:fixed; - mso-font-signature:-1610611985 1073750091 0 0 159 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-unhide:no; - mso-style-qformat:yes; - mso-style-parent:""; - margin:0in; - margin-bottom:.0001pt; - mso-pagination:widow-orphan; - font-size:12.0pt; - font-family:"Times New Roman","serif"; - mso-fareast-font-family:"Times New Roman"; - mso-fareast-theme-font:minor-fareast; - color:black;} -h2 - {mso-style-priority:9; - mso-style-unhide:no; - mso-style-qformat:yes; - mso-style-link:"Heading 2 Char"; - 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","serif"; - mso-fareast-font-family:"Times New Roman"; - mso-fareast-theme-font:minor-fareast; - color:black; - font-weight:bold;} -h3 - {mso-style-priority:9; - mso-style-unhide:no; - mso-style-qformat:yes; - mso-style-link:"Heading 3 Char"; - 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","serif"; - mso-fareast-font-family:"Times New Roman"; - mso-fareast-theme-font:minor-fareast; - color:black; - font-weight:bold;} -h4 - {mso-style-priority:9; - mso-style-unhide:no; - mso-style-qformat:yes; - mso-style-link:"Heading 4 Char"; - 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","serif"; - mso-fareast-font-family:"Times New Roman"; - mso-fareast-theme-font:minor-fareast; - color:black; - font-weight:bold;} -p.MsoHeader, li.MsoHeader, div.MsoHeader - {mso-style-noshow:yes; - mso-style-priority:99; - mso-style-link:"Header Char"; - margin:0in; - margin-bottom:.0001pt; - mso-pagination:widow-orphan; - tab-stops:center 3.25in right 6.5in; - font-size:12.0pt; - font-family:"Times New Roman","serif"; - mso-fareast-font-family:"Times New Roman"; - mso-fareast-theme-font:minor-fareast; - color:black;} -p.MsoFooter, li.MsoFooter, div.MsoFooter - {mso-style-noshow:yes; - mso-style-priority:99; - mso-style-link:"Footer Char"; - margin:0in; - margin-bottom:.0001pt; - mso-pagination:widow-orphan; - tab-stops:center 3.25in right 6.5in; - font-size:12.0pt; - font-family:"Times New Roman","serif"; - mso-fareast-font-family:"Times New Roman"; - mso-fareast-theme-font:minor-fareast; - color:black;} -a:link, span.MsoHyperlink - {mso-style-noshow:yes; - mso-style-priority:99; - color:blue; - text-decoration:underline; - text-underline:single;} -a:visited, span.MsoHyperlinkFollowed - {mso-style-noshow:yes; - mso-style-priority:99; - color:purple; - text-decoration:underline; - text-underline:single;} -p - {mso-style-priority:99; - 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","serif"; - mso-fareast-font-family:"Times New Roman"; - mso-fareast-theme-font:minor-fareast; - color:black;} -pre - {mso-style-priority:99; - mso-style-link:"HTML Preformatted Char"; - 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"; - mso-fareast-theme-font:minor-fareast; - color:black;} -span.Heading2Char - {mso-style-name:"Heading 2 Char"; - mso-style-noshow:yes; - mso-style-priority:9; - mso-style-unhide:no; - mso-style-locked:yes; - mso-style-link:"Heading 2"; - mso-ansi-font-size:13.0pt; - mso-bidi-font-size:13.0pt; - font-family:"Cambria","serif"; - mso-ascii-font-family:Cambria; - mso-ascii-theme-font:major-latin; - mso-fareast-font-family:"Times New Roman"; - mso-fareast-theme-font:major-fareast; - mso-hansi-font-family:Cambria; - mso-hansi-theme-font:major-latin; - mso-bidi-font-family:"Times New Roman"; - mso-bidi-theme-font:major-bidi; - color:#4F81BD; - mso-themecolor:accent1; - font-weight:bold;} -span.Heading3Char - {mso-style-name:"Heading 3 Char"; - mso-style-noshow:yes; - mso-style-priority:9; - mso-style-unhide:no; - mso-style-locked:yes; - mso-style-link:"Heading 3"; - mso-ansi-font-size:12.0pt; - mso-bidi-font-size:12.0pt; - font-family:"Cambria","serif"; - mso-ascii-font-family:Cambria; - mso-ascii-theme-font:major-latin; - mso-fareast-font-family:"Times New Roman"; - mso-fareast-theme-font:major-fareast; - mso-hansi-font-family:Cambria; - mso-hansi-theme-font:major-latin; - mso-bidi-font-family:"Times New Roman"; - mso-bidi-theme-font:major-bidi; - color:#4F81BD; - mso-themecolor:accent1; - font-weight:bold;} -span.Heading4Char - {mso-style-name:"Heading 4 Char"; - mso-style-noshow:yes; - mso-style-priority:9; - mso-style-unhide:no; - mso-style-locked:yes; - mso-style-link:"Heading 4"; - mso-ansi-font-size:12.0pt; - mso-bidi-font-size:12.0pt; - font-family:"Cambria","serif"; - mso-ascii-font-family:Cambria; - mso-ascii-theme-font:major-latin; - mso-fareast-font-family:"Times New Roman"; - mso-fareast-theme-font:major-fareast; - mso-hansi-font-family:Cambria; - mso-hansi-theme-font:major-latin; - mso-bidi-font-family:"Times New Roman"; - mso-bidi-theme-font:major-bidi; - color:#4F81BD; - mso-themecolor:accent1; - font-weight:bold; - font-style:italic;} -span.HTMLPreformattedChar - {mso-style-name:"HTML Preformatted Char"; - mso-style-priority:99; - mso-style-unhide:no; - mso-style-locked:yes; - mso-style-link:"HTML Preformatted"; - font-family:Consolas; - mso-ascii-font-family:Consolas; - mso-fareast-font-family:"Times New Roman"; - mso-fareast-theme-font:minor-fareast; - mso-hansi-font-family:Consolas; - color:black;} -span.HeaderChar - {mso-style-name:"Header Char"; - mso-style-noshow:yes; - mso-style-priority:99; - mso-style-unhide:no; - mso-style-locked:yes; - mso-style-link:Header; - mso-ansi-font-size:12.0pt; - mso-bidi-font-size:12.0pt; - font-family:"Times New Roman","serif"; - mso-fareast-font-family:"Times New Roman"; - mso-fareast-theme-font:minor-fareast; - color:black;} -span.FooterChar - {mso-style-name:"Footer Char"; - mso-style-noshow:yes; - mso-style-priority:99; - mso-style-unhide:no; - mso-style-locked:yes; - mso-style-link:Footer; - mso-ansi-font-size:12.0pt; - mso-bidi-font-size:12.0pt; - font-family:"Times New Roman","serif"; - mso-fareast-font-family:"Times New Roman"; - mso-fareast-theme-font:minor-fareast; - color:black;} -.MsoChpDefault - {mso-style-type:export-only; - mso-default-props:yes; - font-size:10.0pt; - mso-ansi-font-size:10.0pt; - mso-bidi-font-size:10.0pt;} - /* Page Definitions */ - @page - {mso-footnote-separator:url("sdma_files/header.htm") fs; - mso-footnote-continuation-separator:url("sdma_files/header.htm") fcs; - mso-endnote-separator:url("sdma_files/header.htm") es; - mso-endnote-continuation-separator:url("sdma_files/header.htm") ecs;} -@page Section1 - {size:8.5in 11.0in; - margin:1.0in 1.0in 1.0in 1.0in; - mso-header-margin:.5in; - mso-footer-margin:.5in; - mso-even-header:url("sdma_files/header.htm") eh1; - mso-header:url("sdma_files/header.htm") h1; - mso-even-footer:url("sdma_files/header.htm") ef1; - mso-footer:url("sdma_files/header.htm") f1; - mso-first-header:url("sdma_files/header.htm") fh1; - mso-first-footer:url("sdma_files/header.htm") ff1; - 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-priority:99; - mso-style-qformat: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","serif";} -</style> -<![endif]--> -<meta name=Template content="C:\PROGRAM FILES\MICROSOFT OFFICE\OFFICE\html.dot"> -<!--[if gte mso 9]><xml> - <o:shapedefaults v:ext="edit" spidmax="4098"/> -</xml><![endif]--><!--[if gte mso 9]><xml> - <o:shapelayout v:ext="edit"> - <o:idmap v:ext="edit" data="1"/> - </o:shapelayout></xml><![endif]--> -</head> - -<body bgcolor=white lang=EN-US link=blue vlink=purple style='tab-interval:.5in' -leftmargin=8> - -<div class=Section1> - -<h2><a name=MYSAMPLE><span style='font-family:"Verdana","sans-serif"; -mso-fareast-font-family:"Times New Roman"'>SDMA</span></a><span -style='font-family:"Verdana","sans-serif";mso-fareast-font-family:"Times New Roman"'> -<o:p></o:p></span></h2> - -<h3><span style='font-family:"Verdana","sans-serif";mso-fareast-font-family: -"Times New Roman"'>SUMMARY<o:p></o:p></span></h3> - -<p><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'>This -sample demonstrates the usage of V3 System DMA. It shows how a driver -could use a system DMA controller supported by Windows to -write data to a hardware location using DMA.<o:p></o:p></span></p> - -<p><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'>The sample -consists of a legacy device driver and a Win32 console mode test application. -The test application opens a handle to the device exposed by the driver and makes -a DeviceIoControl call to initiate the example system DMA. To understand how -the V3 system DMA calls are invoked please study SDmaWrite() in SDma.c.<o:p></o:p></span></p> - -<p><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'>This -driver will work on Windows 2000 and later operating systems.<o:p></o:p></span></p> - -<p><b><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'>This -sample driver is not a PnP driver. This is a minimal driver meant to -demonstrate an OS feature. Neither it nor its sample programs are intended for -use in a production environment. Rather, they are intended for educational -purposes and as a skeleton driver.</span></b><span style='font-size:10.0pt; -font-family:"Verdana","sans-serif"'><o:p></o:p></span></p> - -<h3><span style='font-family:"Verdana","sans-serif";mso-fareast-font-family: -"Times New Roman"'>BUILDING THE SAMPLE<o:p></o:p></span></h3> - -<p><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'>Click the -Free Build Environment or Checked Build Environment icon under Development Kits -program group to set basic environment variables. <o:p></o:p></span></p> - -<p><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'>Change to -the directory containing the sample source code, such as CD Src\General\sdma\wdm. -<o:p></o:p></span></p> - -<p><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'>Run build --ceZ, or use the macro BLD. This command invokes the Microsoft make routines to -build the components. If the build succeeds, you will find the driver, -sdma.sys, and the test application, SystemDmaApp.exe, in the binary output -directory specified for the build environment. You can get the output path from -the buildxxx.log file (for example, buildfre_win7_arm.log). If the build fails -you can find errors and warnings in the buildxxx.err and buildxxx.wrn respectively, -where xxx is either chk or fre depending on the build environment. <o:p></o:p></span></p> - -<h3><span style='font-family:"Verdana","sans-serif";mso-fareast-font-family: -"Times New Roman"'>TESTING<o:p></o:p></span></h3> - -<p><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'>To test -this driver, copy the test app, SystemDmaApp.exe, and the driver to the same -directory, and run the application. The application will automatically load the -driver if it's not already loaded and interact with the driver. When you exit -the app, the driver will be stopped, unloaded and removed. Because no system DMA -controller exists for Windows which uses the advertised DRQ, the sample driver -will not proceed any further than failing to acquire a system DMA adapter.<o:p></o:p></span></p> - -<h3><span style='mso-fareast-font-family:"Times New Roman"'>CODE TOUR</span><span -style='font-family:"Verdana","sans-serif";mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></h3> - -<h4><span style='font-family:"Verdana","sans-serif";mso-fareast-font-family: -"Times New Roman"'>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>SystemDma.htm<span -style='mso-tab-count:1'>��</span>Sample Tour documentation for this sample (this file).<o:p></o:p></pre><pre>Sources<span -style='mso-tab-count:2'>������� </span>Generic file that lists source files and all the build options.<o:p></o:p></pre><pre>SDma.c<span -style='mso-tab-count:1'>� ����� </span>Source file of the sample driver.<o:p></o:p></pre><pre>SDma.h<span -style='mso-tab-count:1'>��� ��� </span>Header file for defining ioctls; included by driver and the test application.<o:p></o:p></pre><pre>Testapp.c<span -style='mso-tab-count:1'>����� </span>Source file of the test application. Contains routines to send one IOCTL to the driver.<o:p></o:p></pre><pre>Install.c<span -style='mso-tab-count:1'>����� </span>Source file of the test application. Contains routines to load and unload the driver.<o:p></o:p></pre><pre>SDma.rc<span -style='mso-tab-count:1'>��� �� </span>Resource file that specifies information such as file type, version, etc.<o:p></o:p></pre><pre>Makefile<span -style='mso-tab-count:1'>������ </span>This file merely indirects to the real makefile that is shared by all the driver components of the Windows NT DDK.<o:p></o:p></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'><a -href="#top"><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'>Top -of page</span></a><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'> -<o:p></o:p></span></p> - -<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0 width=624 - style='width:6.5in;mso-cellspacing:0in;mso-yfti-tbllook:1184;mso-padding-alt: - 0in 5.4pt 0in 5.4pt'> - <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes; - height:1.5pt'> - <td style='background:aqua;padding:.75pt .75pt .75pt .75pt;height:1.5pt'></td> - </tr> -</table> - -<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","serif"'>� 1998 Microsoft -Corporation</span><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'> -<o:p></o:p></span></p> - -</div> - -</body> - -</html> diff --git a/general/cancel/cancel.htm b/general/cancel/cancel.htm deleted file mode 100644 index cac03a7f..00000000 --- a/general/cancel/cancel.htm +++ /dev/null @@ -1,302 +0,0 @@ -<html xmlns:v="urn:schemas-microsoft-com:vml" -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 11"> -<meta name=Originator content="Microsoft Word 11"> -<link rel=File-List href="cancel_files/filelist.xml"> -<title>CANCEL</title> -<!--[if gte mso 9]><xml> - <w:WordDocument> - <w:Zoom>BestFit</w:Zoom> - <w:SpellingState>Clean</w:SpellingState> - <w:GrammarState>Clean</w:GrammarState> - <w:ValidateAgainstSchemas/> - <w:SaveIfXMLInvalid>false</w:SaveIfXMLInvalid> - <w:IgnoreMixedContent>false</w:IgnoreMixedContent> - <w:AlwaysShowPlaceholderText>false</w:AlwaysShowPlaceholderText> - <w:BrowserLevel>MicrosoftInternetExplorer4</w:BrowserLevel> - </w:WordDocument> -</xml><![endif]--><!--[if gte mso 9]><xml> - <w:LatentStyles DefLockedState="false" LatentStyleCount="156"> - </w:LatentStyles> -</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:purple; - 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;} ---> -</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"; - mso-ansi-language:#0400; - mso-fareast-language:#0400; - mso-bidi-language:#0400;} -</style> -<![endif]--> -<meta name=Template content="C:\PROGRAM FILES\MICROSOFT OFFICE\OFFICE\html.dot"> -<!--[if gte mso 9]><xml> - <o:shapedefaults v:ext="edit" spidmax="3074"/> -</xml><![endif]--><!--[if gte mso 9]><xml> - <o:shapelayout v:ext="edit"> - <o:idmap v:ext="edit" data="1"/> - </o:shapelayout></xml><![endif]--> -</head> - -<body bgcolor=white lang=EN-US link=blue vlink=purple style='tab-interval:.5in' -leftmargin=8> - -<div class=Section1> - -<h2><a name=MYSAMPLE><span style='font-family:Verdana'>CANCEL</span></a><span -style='font-family:Verdana'> <o:p></o:p></span></h2> - -<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 demonstrates -the use of <span class=GramE>new <span style='mso-spacerun:yes'>�</span>cancel</span>-safe -queue (<span class=SpellE>IoCsqInitialize</span>, <span class=SpellE>IoCsqInsertIrp</span>, -<span class=SpellE>IoCsqRemoveIrp</span>, <span class=SpellE>IoCsqRemoveNextIrp</span>) -APIs introduced on Windows XP for queuing <span class=SpellE>IRPs</span> in the -driver's internal device queue. By using these APIs, driver writers do not have -to worry about any IRP cancellation race condition issues. A common problem -with cancellation of <span class=SpellE>IRPs</span> in a driver is -synchronization between the cancel lock <span class=GramE>or</span> the <span -class=SpellE>InterlockedExchange</span> in the I/O Manager with the driver's -queue lock. These APIs abstract the cancel logic while allowing the driver to -implement the queue and associated synchronization. <o:p></o:p></span></p> - -<p><span style='font-size:10.0pt;font-family:Verdana'>The sample is accompanied -by a simple multithreaded Win32 console application to stress-test the driver's -cancel and cleanup routines.<o:p></o:p></span></p> - -<p><span style='font-size:10.0pt;font-family:Verdana'>This driver is written -for <span class=GramE>an</span> hypothetical data acquisition device that -requires polling at a regular interval. The device has some settling period -between two reads. Upon user request the driver reads data and records the -time. When the next read request comes in, it checks the interval to see if -it's reading the device too soon. If so, it <span class=SpellE>pends</span> the -IRP and sleeps for a while and tries again. Upon arrival, <span class=SpellE>IRPs</span> -are queued in a cancel-safe queue and a semaphore is signaled. A polling thread -waiting indefinitely on the semaphore wakes up to the signal and processes <span -class=GramE>queued</span> <span class=SpellE>IRPs</span> sequentially. <o:p></o:p></span></p> - -<p><span style='font-size:10.0pt;font-family:Verdana'>This sample is adapted -from the original cancel sample -(http://support.microsoft.com/support/kb/articles/Q188/2/76.asp) written for -NT4.0. <o:p></o:p></span></p> - -<p><span style='font-size:10.0pt;font-family:Verdana'>The building and -installation instructions given here apply to Windows� 2000 and later operating systems.<o:p></o:p></span></p> - -<p><span style='font-size:10.0pt;font-family:Verdana'>This sample driver is not -a PnP driver. This is a minimal driver meant to demonstrate an OS feature. -Neither it nor its sample programs are intended for use in a production -environment. Rather, they are intended for educational purposes and as a -skeleton driver. <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'>Click the Free Build -Environment or Checked Build Environment icon under Development Kits program -group to set basic environment variables. <o:p></o:p></span></p> - -<p><span style='font-size:10.0pt;font-family:Verdana'>Change to the directory -containing the device source code, such as CD <span class=SpellE>Src</span>\General\Cancel. -<o:p></o:p></span></p> - -<p><span style='font-size:10.0pt;font-family:Verdana'>Run <b>build -<span -class=SpellE>ceZ</span>,</b> or use the macro <b>BLD</b>. This command invokes -the Microsoft make routines to build the components. If the build </span>s<span -style='font-size:10.0pt;font-family:Verdana'>ucceeds, you will find the driver, -<span class=SpellE>cancel.sys</span>, and the test application, canclapp.exe, -in the binary output directory specified for the build environment. You can get the output path from the buildxxx.log file. If it fails you can find errors and warnings in the <span class=SpellE>buildxxx.err</span> -and <span class=SpellE>buildxxx.err</span> respectively, where xxx is either <span -class=SpellE>chk</span> or <span class=SpellE>fre</span> depending on the build -environment. <o:p></o:p></span></p> - -<h3><span style='font-family:Verdana'>STARTIO IMPLEMENTATION<o:p></o:p></span></h3> - -<p><span style='font-size:10.0pt;font-family:Verdana'>In the <span -class=SpellE>startio</span> directory is another version of the sample driver -that shows how to use <span class=GramE>the <span -style='mso-spacerun:yes'>�</span>cancel</span>-safe queues to implement IO -queuing functionality similar to the <span class=SpellE>IoStartPacket/IoStartNextPacket</span> -APIs. The same test application works with this driver as well.</span><span -style='font-family:Verdana'><o:p></o:p></span></p> - -<h3><span style='font-family:Verdana'>TESTING<o:p></o:p></span></h3> - -<p><span style='font-size:10.0pt;font-family:Verdana'>To test this driver, run -Testapp.exe, a simple Win32 multithreaded console mode application. The driver -will be automatically loaded and started. When you exit the app, the driver -will stopped and removed.<o:p></o:p></span></p> - -<p><span class=SpellE><span style='font-size:10.0pt;font-family:Verdana'>Usage<span -class=GramE>:testapp</span></span></span><span style='font-size:10.0pt; -font-family:Verdana'> (<span class=SpellE>NumberOfThreads</span>)<o:p></o:p></span></p> - -<p><b><span style='font-size:10.0pt;font-family:Verdana'>Note</span></b><span -style='font-size:10.0pt;font-family:Verdana'>: <span class=SpellE>NumberOfThreads</span> -is limited to a maximum of 10 threads; the default value if run without the option -is 1. The main thread waits for user input. If you press Q, the application -exits gracefully; otherwise it exits the process abruptly forcing all the -threads to be terminated and all pending I/Os to be canceled. Other threads -perform I/O asynchronously in a loop. After every overlapped read, the thread -goes into an <span class=SpellE>alertable</span> sleep and wakes as soon as -completion routines is executed, when the read IRP gets completed by the -driver. You should run multiple instances of the application to stress test the -driver.<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=GramE>Cancel.htm<span style='mso-tab-count:1'>���� </span>Documentation for this sample (this file).</span></pre><pre><span -class=SpellE>Cancel.c</span><span style='mso-tab-count:1'>������ </span>Source <span -class=GramE>file</span> of the sample driver.</pre><pre><span class=GramE>Sources<span -style='mso-tab-count:2'>������� </span>Generic file that lists source files and all the build options.</span></pre><pre><span -class=SpellE>Testapp.c</span><span style='mso-tab-count:1'>����� </span>Source <span -class=GramE>file</span> of the test application.</pre><pre><span class=SpellE>Install.c</span><span -style='mso-tab-count:1'>����� </span>Contains functions to load/start/stop/remove the driver.</pre><pre><span -class=SpellE>Testapp.h</span><span style='mso-tab-count:1'>����� </span>Header <span -class=GramE>file</span> for common definitions and function prototypes.</pre><pre><span -class=SpellE>Cancel.rc</span><span style='mso-tab-count:1'>����� </span>Resource file that specify information such as file type, version, etc.</pre><pre><span -class=SpellE>Makefile</span><span style='mso-tab-count:1'>������ </span><span -class=GramE>This file</span> merely <span class=SpellE>indirects</span> to the real <span -class=SpellE>makefile</span> that is shared by all the driver components of the Windows NT DDK.</pre> - -<p align=center style='text-align:center'><a href="#top"><span -style='font-size:10.0pt;font-family:Verdana'>Top of page</span></a><span -style='font-size:10.0pt;font-family:Verdana'> <o:p></o:p></span></p> - -<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-firstrow:yes;mso-yfti-lastrow:yes; - height:1.5pt'> - <td style='background:aqua;padding:.75pt .75pt .75pt .75pt;height:1.5pt'> - <p class=MsoNormal><span style='color:black'><o:p> </o:p></span></p> - </td> - </tr> -</table> - -<p><span style='font-size:7.5pt;font-family:"MS Sans Serif"'>� 2004 Microsoft -Corporation</span><span style='font-size:10.0pt;font-family:Verdana'> <span -style='color:black'><o:p></o:p></span></span></p> - -</div> - -</body> - -</html> diff --git a/general/event/event.htm b/general/event/event.htm deleted file mode 100644 index 32485d9a..00000000 --- a/general/event/event.htm +++ /dev/null @@ -1,229 +0,0 @@ -<html> - -<head> -<meta http-equiv=Content-Type content="text/html; charset=windows-1252"> -<meta name=Generator content="Microsoft Word 12 (filtered)"> -<title>EVENT</title> -<style> -<!-- - /* Font Definitions */ - @font-face - {font-family:"Cambria Math"; - panose-1:2 4 5 3 5 4 6 3 2 4;} -@font-face - {font-family:Verdana; - panose-1:2 11 6 4 3 5 4 4 2 4;} -@font-face - {font-family:Consolas; - panose-1:2 11 6 9 2 2 4 3 2 4;} -@font-face - {font-family:"MS Sans Serif"; - panose-1:0 0 0 0 0 0 0 0 0 0;} - /* Style Definitions */ - p.MsoNormal, li.MsoNormal, div.MsoNormal - {margin:0in; - margin-bottom:.0001pt; - font-size:12.0pt; - font-family:"Times New Roman","serif"; - color:black;} -h2 - {mso-style-link:"Heading 2 Char"; - margin-right:0in; - margin-left:0in; - font-size:18.0pt; - font-family:"Times New Roman","serif"; - color:black; - font-weight:bold;} -h3 - {mso-style-link:"Heading 3 Char"; - margin-right:0in; - margin-left:0in; - font-size:13.5pt; - font-family:"Times New Roman","serif"; - color:black; - font-weight:bold;} -h4 - {mso-style-link:"Heading 4 Char"; - margin-right:0in; - margin-left:0in; - font-size:12.0pt; - font-family:"Times New Roman","serif"; - color:black; - font-weight:bold;} -a:link, span.MsoHyperlink - {color:blue; - text-decoration:underline;} -a:visited, span.MsoHyperlinkFollowed - {color:purple; - text-decoration:underline;} -p - {margin-right:0in; - margin-left:0in; - font-size:12.0pt; - font-family:"Times New Roman","serif"; - color:black;} -pre - {mso-style-link:"HTML Preformatted Char"; - margin:0in; - margin-bottom:.0001pt; - font-size:10.0pt; - font-family:"Courier New"; - color:black;} -span.Heading2Char - {mso-style-name:"Heading 2 Char"; - mso-style-link:"Heading 2"; - font-family:"Cambria","serif"; - color:#4F81BD; - font-weight:bold;} -span.Heading3Char - {mso-style-name:"Heading 3 Char"; - mso-style-link:"Heading 3"; - font-family:"Cambria","serif"; - color:#4F81BD; - font-weight:bold;} -span.Heading4Char - {mso-style-name:"Heading 4 Char"; - mso-style-link:"Heading 4"; - font-family:"Cambria","serif"; - color:#4F81BD; - font-weight:bold; - font-style:italic;} -span.HTMLPreformattedChar - {mso-style-name:"HTML Preformatted Char"; - mso-style-link:"HTML Preformatted"; - font-family:Consolas; - color:black;} -.MsoChpDefault - {font-size:10.0pt;} -@page Section1 - {size:8.5in 11.0in; - margin:1.0in 1.0in 1.0in 1.0in;} -div.Section1 - {page:Section1;} ---> -</style> - -<meta name=Template content="C:\PROGRAM FILES\MICROSOFT OFFICE\OFFICE\html.dot"> -</head> - -<body bgcolor=white lang=EN-US link=blue vlink=purple leftmargin=8> - -<div class=Section1> - -<h2><a name=MYSAMPLE><span style='font-family:"Verdana","sans-serif"'>EVENT</span></a><span -style='font-family:"Verdana","sans-serif"'> </span></h2> - -<h3><span style='font-family:"Verdana","sans-serif"'>SUMMARY</span></h3> - -<p><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'>This -sample demonstrates two different ways a Windows NT kernel-mode driver can -notify an application about a hardware event. One is event based method and the -other is an IRP based method. Since the sample driver is not talking to any -real hardware, it uses a timer DPC to simulate hardware events. The test -application informs the driver whether it wants to be notified by signaling an -event or by completing the pending IRP and also gives a relative time at which -the DPC timer has to fire. </span></p> - -<p><b><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'>Event -based approach:</span></b><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'> -The application creates an event using CreateEvent(). It then passes the event -handle to the driver in a private ioctl IOCTL_REGISTER_EVENT. Since the driver -is a monolithic toplevel driver, its IRP dispatch routines run in the -application process context and as a result the event handle is still valid in -the driver. The driver dereferences the user-mode handle into system space -& saves the event object pointer for later use and queues a custom timer -DPC. When the DPC fires, the driver signals the event via KeSetEvent() at -DISPATCH_LEVEL and deletes the references to the event object. You can't use -this approach if your driver is not a monolithic - toplevel driver, because you -can't guarantee the process context in a multi-level driver stack if you are -not at the top.</span></p> - -<p><b><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'>Pending -IRP based approach:</span></b><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'> -The application make a synchronous ioctl(IOCTL_REGISTER_EVENT) request. The -driver marks the device I/O control IRP pending and queues a timer DPC and -returns STATUS_PENDING. When the timer fires to indicate a hardware event, the -driver completes the pending IRP to notify the application about the hardware -event. </span></p> - -<p><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'>There are -two advantages of this method over the event based approach. One is that you -can send a message to the application along with your notification and other -one is that the driver routines don't have to be in the context of the process -that made the request. The application can do a synchronous or asynchronous -(overlapped) ioctl to the driver. </span></p> - -<p><b><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'>This -sample driver is not a PnP driver. This is a minimal driver meant to -demonstrate an OS feature. Neither it nor its sample programs are intended for -use in a production environment. Rather, they are intended for educational -purposes and as a skeleton driver.</span></b></p> - -<p><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'>This driver -will work on Windows NT 4.0, Windows 2000 and later operating systems.</span></p> - -<h3><span style='font-family:"Verdana","sans-serif"'>BUILDING THE SAMPLE</span></h3> - -<p><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'>Click the -Free Build Environment or Checked Build Environment icon under Development Kits -program group to set basic environment variables. </span></p> - -<p><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'>Change to -the directory containing the device source code, such as CD Src\General\Event. </span></p> - -<p><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'>Run <b>build --ceZ,</b> or use the macro <b>BLD</b>. This command invokes the Microsoft make -routines to build the components. If the build succeeds, you will find the -driver, event.sys, and the test application, event.exe, in the binary output directory specified for the build environment. You can get the output path from the buildxxx.log file. If the build -fails you can find errors and warnings in the buildxxx.err and buildxxx.err -respectively, where xxx is eithr chk or fre depending on the build environment. -</span></p> - -<h3><span style='font-family:"Verdana","sans-serif"'>TESTING</span></h3> - -<p><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'>To test -this driver, copy the test app, event.exe, and the driver to the same -directory, and run the application. The application will automatically load the -driver if it's not already loaded and interact with the driver. When you exit -the app, the driver will be stopped, unloaded and removed. </span></p> - -<p><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'>c:\>Event.exe -DELAY </span><0/1></p> - -<p><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'>where -DELAY equals the time to delay the Event signal in seconds.</span></p> - -<p><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'>Specify O -for IRP based notification and 1 for event based notification.</span></p> - -<h3><span style='font-family:"Verdana","sans-serif"'>CODE TOUR</span></h3> - -<h4><span style='font-family:"Verdana","sans-serif"'>File Manifest</span></h4> - -<pre><u>File���������� Description</u></pre><pre> </pre><pre> </pre><pre>Event.htm����� Documentation for the sample (this file)</pre><pre> </pre><pre>Exe\Sources��� Generic file for building the test app</pre><pre>Exe\Eventtest.c Simple console test application</pre><pre>Exe\install.c� Code for registering and starting the driver service</pre><pre> </pre><pre>Wdm\Sources��� Generic file for building the driver</pre><pre>Wdm\Event.h��� Header file private to the driver</pre><pre>Wdm\public.h�� Common header file between app and driver</pre><pre>Wdm\Event.c��� Main driver file</pre><pre>Wdm\Event.rc�� Driver resource file</pre><pre> </pre> - -<p align=center style='text-align:center'><span style='font-size:10.0pt; -font-family:"Courier New"'><a href="#top"><span style='font-family:"Verdana","sans-serif"'>Top -of page</span></a></span><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'> -</span></p> - -<pre> </pre> - -<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0 width=624 - style='width:6.5in'> - <tr style='height:1.5pt'> - <td style='background:aqua;padding:.75pt .75pt .75pt .75pt;height:1.5pt'></td> - </tr> -</table> - -<pre> </pre><pre> </pre> - -<p><span style='font-size:7.5pt;font-family:"MS Sans Serif","serif"'>� 1998 -Microsoft Corporation</span><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'> -</span></p> - -</div> - -</body> - -</html> diff --git a/general/ioctl/wdm/ioctl.htm b/general/ioctl/wdm/ioctl.htm deleted file mode 100644 index bfce1a9e..00000000 --- a/general/ioctl/wdm/ioctl.htm +++ /dev/null @@ -1,742 +0,0 @@ -<html xmlns:v="urn:schemas-microsoft-com:vml" -xmlns:o="urn:schemas-microsoft-com:office:office" -xmlns:w="urn:schemas-microsoft-com:office:word" -xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" -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 12"> -<meta name=Originator content="Microsoft Word 12"> -<link rel=File-List href="ioctl_files/filelist.xml"> -<!--[if gte mso 9]><xml> - <o:OfficeDocumentSettings> - <o:RemovePersonalInformation/> - <o:RemoveDateAndTime/> - </o:OfficeDocumentSettings> -</xml><![endif]--> -<link rel=themeData href="ioctl_files/themedata.thmx"> -<link rel=colorSchemeMapping href="ioctl_files/colorschememapping.xml"> -<!--[if gte mso 9]><xml> - <w:WordDocument> - <w:TrackMoves>false</w:TrackMoves> - <w:TrackFormatting/> - <w:ValidateAgainstSchemas/> - <w:SaveIfXMLInvalid>false</w:SaveIfXMLInvalid> - <w:IgnoreMixedContent>false</w:IgnoreMixedContent> - <w:AlwaysShowPlaceholderText>false</w:AlwaysShowPlaceholderText> - <w:DoNotPromoteQF/> - <w:LidThemeOther>EN-US</w:LidThemeOther> - <w:LidThemeAsian>X-NONE</w:LidThemeAsian> - <w:LidThemeComplexScript>X-NONE</w:LidThemeComplexScript> - <w:Compatibility> - <w:BreakWrappedTables/> - <w:SnapToGridInCell/> - <w:WrapTextWithPunct/> - <w:UseAsianBreakRules/> - <w:DontGrowAutofit/> - <w:SplitPgBreakAndParaMark/> - <w:DontVertAlignCellWithSp/> - <w:DontBreakConstrainedForcedTables/> - <w:DontVertAlignInTxbx/> - <w:Word11KerningPairs/> - <w:CachedColBalance/> - </w:Compatibility> - <w:BrowserLevel>MicrosoftInternetExplorer4</w:BrowserLevel> - <m:mathPr> - <m:mathFont m:val="Cambria Math"/> - <m:brkBin m:val="before"/> - <m:brkBinSub m:val="--"/> - <m:smallFrac m:val="off"/> - <m:dispDef/> - <m:lMargin m:val="0"/> - <m:rMargin m:val="0"/> - <m:defJc m:val="centerGroup"/> - <m:wrapIndent m:val="1440"/> - <m:intLim m:val="subSup"/> - <m:naryLim m:val="undOvr"/> - </m:mathPr></w:WordDocument> -</xml><![endif]--><!--[if gte mso 9]><xml> - <w:LatentStyles DefLockedState="false" DefUnhideWhenUsed="true" - DefSemiHidden="true" DefQFormat="false" DefPriority="99" - LatentStyleCount="267"> - <w:LsdException Locked="false" Priority="0" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Normal"/> - <w:LsdException Locked="false" Priority="9" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="heading 1"/> - <w:LsdException Locked="false" Priority="9" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="heading 2"/> - <w:LsdException Locked="false" Priority="9" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="heading 3"/> - <w:LsdException Locked="false" Priority="9" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="heading 4"/> - <w:LsdException Locked="false" Priority="9" QFormat="true" Name="heading 5"/> - <w:LsdException Locked="false" Priority="9" QFormat="true" Name="heading 6"/> - <w:LsdException Locked="false" Priority="9" QFormat="true" Name="heading 7"/> - <w:LsdException Locked="false" Priority="9" QFormat="true" Name="heading 8"/> - <w:LsdException Locked="false" Priority="9" QFormat="true" Name="heading 9"/> - <w:LsdException Locked="false" Priority="39" Name="toc 1"/> - <w:LsdException Locked="false" Priority="39" Name="toc 2"/> - <w:LsdException Locked="false" Priority="39" Name="toc 3"/> - <w:LsdException Locked="false" Priority="39" Name="toc 4"/> - <w:LsdException Locked="false" Priority="39" Name="toc 5"/> - <w:LsdException Locked="false" Priority="39" Name="toc 6"/> - <w:LsdException Locked="false" Priority="39" Name="toc 7"/> - <w:LsdException Locked="false" Priority="39" Name="toc 8"/> - <w:LsdException Locked="false" Priority="39" Name="toc 9"/> - <w:LsdException Locked="false" Priority="35" QFormat="true" Name="caption"/> - <w:LsdException Locked="false" Priority="10" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Title"/> - <w:LsdException Locked="false" Priority="1" Name="Default Paragraph Font"/> - <w:LsdException Locked="false" Priority="11" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Subtitle"/> - <w:LsdException Locked="false" Priority="22" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Strong"/> - <w:LsdException Locked="false" Priority="20" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Emphasis"/> - <w:LsdException Locked="false" Priority="59" SemiHidden="false" - UnhideWhenUsed="false" Name="Table Grid"/> - <w:LsdException Locked="false" UnhideWhenUsed="false" Name="Placeholder Text"/> - <w:LsdException Locked="false" Priority="1" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="No Spacing"/> - <w:LsdException Locked="false" Priority="60" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Shading"/> - <w:LsdException Locked="false" Priority="61" SemiHidden="false" - UnhideWhenUsed="false" Name="Light List"/> - <w:LsdException Locked="false" Priority="62" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Grid"/> - <w:LsdException Locked="false" Priority="63" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 1"/> - <w:LsdException Locked="false" Priority="64" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 2"/> - <w:LsdException Locked="false" Priority="65" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 1"/> - <w:LsdException Locked="false" Priority="66" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 2"/> - <w:LsdException Locked="false" Priority="67" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 1"/> - <w:LsdException Locked="false" Priority="68" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 2"/> - <w:LsdException Locked="false" Priority="69" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 3"/> - <w:LsdException Locked="false" Priority="70" SemiHidden="false" - UnhideWhenUsed="false" Name="Dark List"/> - <w:LsdException Locked="false" Priority="71" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Shading"/> - <w:LsdException Locked="false" Priority="72" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful List"/> - <w:LsdException Locked="false" Priority="73" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Grid"/> - <w:LsdException Locked="false" Priority="60" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Shading Accent 1"/> - <w:LsdException Locked="false" Priority="61" SemiHidden="false" - UnhideWhenUsed="false" Name="Light List Accent 1"/> - <w:LsdException Locked="false" Priority="62" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Grid Accent 1"/> - <w:LsdException Locked="false" Priority="63" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 1 Accent 1"/> - <w:LsdException Locked="false" Priority="64" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 2 Accent 1"/> - <w:LsdException Locked="false" Priority="65" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 1 Accent 1"/> - <w:LsdException Locked="false" UnhideWhenUsed="false" Name="Revision"/> - <w:LsdException Locked="false" Priority="34" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="List Paragraph"/> - <w:LsdException Locked="false" Priority="29" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Quote"/> - <w:LsdException Locked="false" Priority="30" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Intense Quote"/> - <w:LsdException Locked="false" Priority="66" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 2 Accent 1"/> - <w:LsdException Locked="false" Priority="67" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 1 Accent 1"/> - <w:LsdException Locked="false" Priority="68" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 2 Accent 1"/> - <w:LsdException Locked="false" Priority="69" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 3 Accent 1"/> - <w:LsdException Locked="false" Priority="70" SemiHidden="false" - UnhideWhenUsed="false" Name="Dark List Accent 1"/> - <w:LsdException Locked="false" Priority="71" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Shading Accent 1"/> - <w:LsdException Locked="false" Priority="72" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful List Accent 1"/> - <w:LsdException Locked="false" Priority="73" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Grid Accent 1"/> - <w:LsdException Locked="false" Priority="60" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Shading Accent 2"/> - <w:LsdException Locked="false" Priority="61" SemiHidden="false" - UnhideWhenUsed="false" Name="Light List Accent 2"/> - <w:LsdException Locked="false" Priority="62" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Grid Accent 2"/> - <w:LsdException Locked="false" Priority="63" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 1 Accent 2"/> - <w:LsdException Locked="false" Priority="64" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 2 Accent 2"/> - <w:LsdException Locked="false" Priority="65" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 1 Accent 2"/> - <w:LsdException Locked="false" Priority="66" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 2 Accent 2"/> - <w:LsdException Locked="false" Priority="67" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 1 Accent 2"/> - <w:LsdException Locked="false" Priority="68" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 2 Accent 2"/> - <w:LsdException Locked="false" Priority="69" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 3 Accent 2"/> - <w:LsdException Locked="false" Priority="70" SemiHidden="false" - UnhideWhenUsed="false" Name="Dark List Accent 2"/> - <w:LsdException Locked="false" Priority="71" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Shading Accent 2"/> - <w:LsdException Locked="false" Priority="72" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful List Accent 2"/> - <w:LsdException Locked="false" Priority="73" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Grid Accent 2"/> - <w:LsdException Locked="false" Priority="60" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Shading Accent 3"/> - <w:LsdException Locked="false" Priority="61" SemiHidden="false" - UnhideWhenUsed="false" Name="Light List Accent 3"/> - <w:LsdException Locked="false" Priority="62" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Grid Accent 3"/> - <w:LsdException Locked="false" Priority="63" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 1 Accent 3"/> - <w:LsdException Locked="false" Priority="64" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 2 Accent 3"/> - <w:LsdException Locked="false" Priority="65" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 1 Accent 3"/> - <w:LsdException Locked="false" Priority="66" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 2 Accent 3"/> - <w:LsdException Locked="false" Priority="67" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 1 Accent 3"/> - <w:LsdException Locked="false" Priority="68" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 2 Accent 3"/> - <w:LsdException Locked="false" Priority="69" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 3 Accent 3"/> - <w:LsdException Locked="false" Priority="70" SemiHidden="false" - UnhideWhenUsed="false" Name="Dark List Accent 3"/> - <w:LsdException Locked="false" Priority="71" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Shading Accent 3"/> - <w:LsdException Locked="false" Priority="72" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful List Accent 3"/> - <w:LsdException Locked="false" Priority="73" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Grid Accent 3"/> - <w:LsdException Locked="false" Priority="60" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Shading Accent 4"/> - <w:LsdException Locked="false" Priority="61" SemiHidden="false" - UnhideWhenUsed="false" Name="Light List Accent 4"/> - <w:LsdException Locked="false" Priority="62" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Grid Accent 4"/> - <w:LsdException Locked="false" Priority="63" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 1 Accent 4"/> - <w:LsdException Locked="false" Priority="64" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 2 Accent 4"/> - <w:LsdException Locked="false" Priority="65" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 1 Accent 4"/> - <w:LsdException Locked="false" Priority="66" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 2 Accent 4"/> - <w:LsdException Locked="false" Priority="67" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 1 Accent 4"/> - <w:LsdException Locked="false" Priority="68" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 2 Accent 4"/> - <w:LsdException Locked="false" Priority="69" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 3 Accent 4"/> - <w:LsdException Locked="false" Priority="70" SemiHidden="false" - UnhideWhenUsed="false" Name="Dark List Accent 4"/> - <w:LsdException Locked="false" Priority="71" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Shading Accent 4"/> - <w:LsdException Locked="false" Priority="72" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful List Accent 4"/> - <w:LsdException Locked="false" Priority="73" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Grid Accent 4"/> - <w:LsdException Locked="false" Priority="60" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Shading Accent 5"/> - <w:LsdException Locked="false" Priority="61" SemiHidden="false" - UnhideWhenUsed="false" Name="Light List Accent 5"/> - <w:LsdException Locked="false" Priority="62" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Grid Accent 5"/> - <w:LsdException Locked="false" Priority="63" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 1 Accent 5"/> - <w:LsdException Locked="false" Priority="64" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 2 Accent 5"/> - <w:LsdException Locked="false" Priority="65" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 1 Accent 5"/> - <w:LsdException Locked="false" Priority="66" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 2 Accent 5"/> - <w:LsdException Locked="false" Priority="67" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 1 Accent 5"/> - <w:LsdException Locked="false" Priority="68" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 2 Accent 5"/> - <w:LsdException Locked="false" Priority="69" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 3 Accent 5"/> - <w:LsdException Locked="false" Priority="70" SemiHidden="false" - UnhideWhenUsed="false" Name="Dark List Accent 5"/> - <w:LsdException Locked="false" Priority="71" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Shading Accent 5"/> - <w:LsdException Locked="false" Priority="72" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful List Accent 5"/> - <w:LsdException Locked="false" Priority="73" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Grid Accent 5"/> - <w:LsdException Locked="false" Priority="60" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Shading Accent 6"/> - <w:LsdException Locked="false" Priority="61" SemiHidden="false" - UnhideWhenUsed="false" Name="Light List Accent 6"/> - <w:LsdException Locked="false" Priority="62" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Grid Accent 6"/> - <w:LsdException Locked="false" Priority="63" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 1 Accent 6"/> - <w:LsdException Locked="false" Priority="64" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 2 Accent 6"/> - <w:LsdException Locked="false" Priority="65" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 1 Accent 6"/> - <w:LsdException Locked="false" Priority="66" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 2 Accent 6"/> - <w:LsdException Locked="false" Priority="67" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 1 Accent 6"/> - <w:LsdException Locked="false" Priority="68" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 2 Accent 6"/> - <w:LsdException Locked="false" Priority="69" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 3 Accent 6"/> - <w:LsdException Locked="false" Priority="70" SemiHidden="false" - UnhideWhenUsed="false" Name="Dark List Accent 6"/> - <w:LsdException Locked="false" Priority="71" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Shading Accent 6"/> - <w:LsdException Locked="false" Priority="72" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful List Accent 6"/> - <w:LsdException Locked="false" Priority="73" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Grid Accent 6"/> - <w:LsdException Locked="false" Priority="19" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Subtle Emphasis"/> - <w:LsdException Locked="false" Priority="21" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Intense Emphasis"/> - <w:LsdException Locked="false" Priority="31" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Subtle Reference"/> - <w:LsdException Locked="false" Priority="32" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Intense Reference"/> - <w:LsdException Locked="false" Priority="33" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Book Title"/> - <w:LsdException Locked="false" Priority="37" Name="Bibliography"/> - <w:LsdException Locked="false" Priority="39" QFormat="true" Name="TOC Heading"/> - </w:LatentStyles> -</xml><![endif]--> -<style> -<!-- - /* Font Definitions */ - @font-face - {font-family:"Cambria Math"; - panose-1:2 4 5 3 5 4 6 3 2 4; - mso-font-charset:0; - mso-generic-font-family:roman; - mso-font-pitch:variable; - mso-font-signature:-1610611985 1107304683 0 0 159 0;} -@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:-1593833729 1073750107 16 0 415 0;} -@font-face - {font-family:Consolas; - panose-1:2 11 6 9 2 2 4 3 2 4; - mso-font-charset:0; - mso-generic-font-family:modern; - mso-font-pitch:fixed; - mso-font-signature:-1610611985 1073750091 0 0 159 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-unhide:no; - mso-style-qformat:yes; - mso-style-parent:""; - margin:0in; - margin-bottom:.0001pt; - mso-pagination:widow-orphan; - font-size:12.0pt; - font-family:"Times New Roman","serif"; - mso-fareast-font-family:"Times New Roman"; - mso-fareast-theme-font:minor-fareast; - color:black;} -h2 - {mso-style-priority:9; - mso-style-unhide:no; - mso-style-qformat:yes; - mso-style-link:"Heading 2 Char"; - 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","serif"; - mso-fareast-font-family:"Times New Roman"; - mso-fareast-theme-font:minor-fareast; - color:black; - font-weight:bold;} -h3 - {mso-style-priority:9; - mso-style-unhide:no; - mso-style-qformat:yes; - mso-style-link:"Heading 3 Char"; - 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","serif"; - mso-fareast-font-family:"Times New Roman"; - mso-fareast-theme-font:minor-fareast; - color:black; - font-weight:bold;} -h4 - {mso-style-priority:9; - mso-style-unhide:no; - mso-style-qformat:yes; - mso-style-link:"Heading 4 Char"; - 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","serif"; - mso-fareast-font-family:"Times New Roman"; - mso-fareast-theme-font:minor-fareast; - color:black; - font-weight:bold;} -p.MsoHeader, li.MsoHeader, div.MsoHeader - {mso-style-noshow:yes; - mso-style-priority:99; - mso-style-link:"Header Char"; - margin:0in; - margin-bottom:.0001pt; - mso-pagination:widow-orphan; - tab-stops:center 3.25in right 6.5in; - font-size:12.0pt; - font-family:"Times New Roman","serif"; - mso-fareast-font-family:"Times New Roman"; - mso-fareast-theme-font:minor-fareast; - color:black;} -p.MsoFooter, li.MsoFooter, div.MsoFooter - {mso-style-noshow:yes; - mso-style-priority:99; - mso-style-link:"Footer Char"; - margin:0in; - margin-bottom:.0001pt; - mso-pagination:widow-orphan; - tab-stops:center 3.25in right 6.5in; - font-size:12.0pt; - font-family:"Times New Roman","serif"; - mso-fareast-font-family:"Times New Roman"; - mso-fareast-theme-font:minor-fareast; - color:black;} -a:link, span.MsoHyperlink - {mso-style-noshow:yes; - mso-style-priority:99; - color:blue; - text-decoration:underline; - text-underline:single;} -a:visited, span.MsoHyperlinkFollowed - {mso-style-noshow:yes; - mso-style-priority:99; - color:purple; - text-decoration:underline; - text-underline:single;} -p - {mso-style-priority:99; - 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","serif"; - mso-fareast-font-family:"Times New Roman"; - mso-fareast-theme-font:minor-fareast; - color:black;} -pre - {mso-style-priority:99; - mso-style-link:"HTML Preformatted Char"; - 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"; - mso-fareast-theme-font:minor-fareast; - color:black;} -span.Heading2Char - {mso-style-name:"Heading 2 Char"; - mso-style-noshow:yes; - mso-style-priority:9; - mso-style-unhide:no; - mso-style-locked:yes; - mso-style-link:"Heading 2"; - mso-ansi-font-size:13.0pt; - mso-bidi-font-size:13.0pt; - font-family:"Cambria","serif"; - mso-ascii-font-family:Cambria; - mso-ascii-theme-font:major-latin; - mso-fareast-font-family:"Times New Roman"; - mso-fareast-theme-font:major-fareast; - mso-hansi-font-family:Cambria; - mso-hansi-theme-font:major-latin; - mso-bidi-font-family:"Times New Roman"; - mso-bidi-theme-font:major-bidi; - color:#4F81BD; - mso-themecolor:accent1; - font-weight:bold;} -span.Heading3Char - {mso-style-name:"Heading 3 Char"; - mso-style-noshow:yes; - mso-style-priority:9; - mso-style-unhide:no; - mso-style-locked:yes; - mso-style-link:"Heading 3"; - mso-ansi-font-size:12.0pt; - mso-bidi-font-size:12.0pt; - font-family:"Cambria","serif"; - mso-ascii-font-family:Cambria; - mso-ascii-theme-font:major-latin; - mso-fareast-font-family:"Times New Roman"; - mso-fareast-theme-font:major-fareast; - mso-hansi-font-family:Cambria; - mso-hansi-theme-font:major-latin; - mso-bidi-font-family:"Times New Roman"; - mso-bidi-theme-font:major-bidi; - color:#4F81BD; - mso-themecolor:accent1; - font-weight:bold;} -span.Heading4Char - {mso-style-name:"Heading 4 Char"; - mso-style-noshow:yes; - mso-style-priority:9; - mso-style-unhide:no; - mso-style-locked:yes; - mso-style-link:"Heading 4"; - mso-ansi-font-size:12.0pt; - mso-bidi-font-size:12.0pt; - font-family:"Cambria","serif"; - mso-ascii-font-family:Cambria; - mso-ascii-theme-font:major-latin; - mso-fareast-font-family:"Times New Roman"; - mso-fareast-theme-font:major-fareast; - mso-hansi-font-family:Cambria; - mso-hansi-theme-font:major-latin; - mso-bidi-font-family:"Times New Roman"; - mso-bidi-theme-font:major-bidi; - color:#4F81BD; - mso-themecolor:accent1; - font-weight:bold; - font-style:italic;} -span.HTMLPreformattedChar - {mso-style-name:"HTML Preformatted Char"; - mso-style-priority:99; - mso-style-unhide:no; - mso-style-locked:yes; - mso-style-link:"HTML Preformatted"; - font-family:Consolas; - mso-ascii-font-family:Consolas; - mso-fareast-font-family:"Times New Roman"; - mso-fareast-theme-font:minor-fareast; - mso-hansi-font-family:Consolas; - color:black;} -span.HeaderChar - {mso-style-name:"Header Char"; - mso-style-noshow:yes; - mso-style-priority:99; - mso-style-unhide:no; - mso-style-locked:yes; - mso-style-link:Header; - mso-ansi-font-size:12.0pt; - mso-bidi-font-size:12.0pt; - font-family:"Times New Roman","serif"; - mso-fareast-font-family:"Times New Roman"; - mso-fareast-theme-font:minor-fareast; - color:black;} -span.FooterChar - {mso-style-name:"Footer Char"; - mso-style-noshow:yes; - mso-style-priority:99; - mso-style-unhide:no; - mso-style-locked:yes; - mso-style-link:Footer; - mso-ansi-font-size:12.0pt; - mso-bidi-font-size:12.0pt; - font-family:"Times New Roman","serif"; - mso-fareast-font-family:"Times New Roman"; - mso-fareast-theme-font:minor-fareast; - color:black;} -.MsoChpDefault - {mso-style-type:export-only; - mso-default-props:yes; - font-size:10.0pt; - mso-ansi-font-size:10.0pt; - mso-bidi-font-size:10.0pt;} - /* Page Definitions */ - @page - {mso-footnote-separator:url("ioctl_files/header.htm") fs; - mso-footnote-continuation-separator:url("ioctl_files/header.htm") fcs; - mso-endnote-separator:url("ioctl_files/header.htm") es; - mso-endnote-continuation-separator:url("ioctl_files/header.htm") ecs;} -@page Section1 - {size:8.5in 11.0in; - margin:1.0in 1.0in 1.0in 1.0in; - mso-header-margin:.5in; - mso-footer-margin:.5in; - mso-even-header:url("ioctl_files/header.htm") eh1; - mso-header:url("ioctl_files/header.htm") h1; - mso-even-footer:url("ioctl_files/header.htm") ef1; - mso-footer:url("ioctl_files/header.htm") f1; - mso-first-header:url("ioctl_files/header.htm") fh1; - mso-first-footer:url("ioctl_files/header.htm") ff1; - 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-priority:99; - mso-style-qformat: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","serif";} -</style> -<![endif]--> -<meta name=Template content="C:\PROGRAM FILES\MICROSOFT OFFICE\OFFICE\html.dot"> -<!--[if gte mso 9]><xml> - <o:shapedefaults v:ext="edit" spidmax="4098"/> -</xml><![endif]--><!--[if gte mso 9]><xml> - <o:shapelayout v:ext="edit"> - <o:idmap v:ext="edit" data="1"/> - </o:shapelayout></xml><![endif]--> -</head> - -<body bgcolor=white lang=EN-US link=blue vlink=purple style='tab-interval:.5in' -leftmargin=8> - -<div class=Section1> - -<h2><a name=MYSAMPLE><span style='font-family:"Verdana","sans-serif"; -mso-fareast-font-family:"Times New Roman"'>IOCTL</span></a><span -style='font-family:"Verdana","sans-serif";mso-fareast-font-family:"Times New Roman"'> -<o:p></o:p></span></h2> - -<h3><span style='font-family:"Verdana","sans-serif";mso-fareast-font-family: -"Times New Roman"'>SUMMARY<o:p></o:p></span></h3> - -<p><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'>This -sample demonstrates the usage of four different types of IOCTLs -(METHOD_IN_DIRECT, METHOD_OUT_DIRECT, METHOD_NEITHER, and METHOD_BUFFERED) -supported by Windows, and how the user input & output buffer specified in -the DeviceControl function is handled by the I/O subsystem and the driver in -each case.<o:p></o:p></span></p> - -<p><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'>The sample -consists of a legacy device driver and a Win32 console mode test application. -The test application opens a handle to the device exposed by the driver and makes -all four different DeviceIoControl calls one after another. To understand how -the IRP fields are set the I/O manager, you should run the checked build version -of the driver and see the debug output.<o:p></o:p></span></p> - -<p><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'>This -driver will work on Windows 2000 and later operating systems.<o:p></o:p></span></p> - -<p><b><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'>This -sample driver is not a PnP driver. This is a minimal driver meant to -demonstrate an OS feature. Neither it nor its sample programs are intended for -use in a production environment. Rather, they are intended for educational -purposes and as a skeleton driver.</span></b><span style='font-size:10.0pt; -font-family:"Verdana","sans-serif"'><o:p></o:p></span></p> - -<h3><span style='font-family:"Verdana","sans-serif";mso-fareast-font-family: -"Times New Roman"'>BUILDING THE SAMPLE<o:p></o:p></span></h3> - -<p><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'>Click the -Free Build Environment or Checked Build Environment icon under Development Kits -program group to set basic environment variables. <o:p></o:p></span></p> - -<p><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'>Change to -the directory containing the sample source code, such as CD Src\General\ioctl\wdm. -<o:p></o:p></span></p> - -<p><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'>Run build --ceZ, or use the macro BLD. This command invokes the Microsoft make routines to -build the components. If the build succeeds, you will find the driver, -sioctl.sys, and the test application, ioctlapp.exe, in the binary output -directory specified for the build environment. You can get the output path from -the buildxxx.log file (for example, buildfre_win7_x86.log). If the build fails -you can find errors and warnings in the buildxxx.err and buildxxx.wrn respectively, -where xxx is either chk or fre depending on the build environment. <o:p></o:p></span></p> - -<h3><span style='font-family:"Verdana","sans-serif";mso-fareast-font-family: -"Times New Roman"'>TESTING<o:p></o:p></span></h3> - -<p><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'>To test -this driver, copy the test app, ioctlapp.exe, and the driver to the same -directory, and run the application. The application will automatically load the -driver if it's not already loaded and interact with the driver. When you exit -the app, the driver will be stopped, unloaded and removed. <o:p></o:p></span></p> - -<h3><span style='mso-fareast-font-family:"Times New Roman"'>CODE TOUR</span><span -style='font-family:"Verdana","sans-serif";mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></h3> - -<h4><span style='font-family:"Verdana","sans-serif";mso-fareast-font-family: -"Times New Roman"'>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>Ioctl.htm<span -style='mso-tab-count:1'>����� </span>Sample Tour documentation for this sample (this file).<o:p></o:p></pre><pre>Sources<span -style='mso-tab-count:2'>������� </span>Generic file that lists source files and all the build options.<o:p></o:p></pre><pre>Sioctl.c<span -style='mso-tab-count:1'>������ </span>Source file of the sample driver.<o:p></o:p></pre><pre>Sioctl.h<span -style='mso-tab-count:1'>������ </span>Header file for defining ioctls; included by driver and the test application.<o:p></o:p></pre><pre>Testapp.c<span -style='mso-tab-count:1'>����� </span>Source file of the test application. Contains routines to send IOCTLs to the driver.<o:p></o:p></pre><pre>Install.c<span -style='mso-tab-count:1'>����� </span>Source file of the test application. Contains routines to load and unload the driver.<o:p></o:p></pre><pre>Sioctl.rc<span -style='mso-tab-count:1'>����� </span>Resource file that specifies information such as file type, version, etc.<o:p></o:p></pre><pre>Makefile<span -style='mso-tab-count:1'>������ </span>This file merely indirects to the real makefile that is shared by all the driver components of the Windows NT DDK.<o:p></o:p></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'><a -href="#top"><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'>Top -of page</span></a><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'> -<o:p></o:p></span></p> - -<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0 width=624 - style='width:6.5in;mso-cellspacing:0in;mso-yfti-tbllook:1184;mso-padding-alt: - 0in 5.4pt 0in 5.4pt'> - <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes; - height:1.5pt'> - <td style='background:aqua;padding:.75pt .75pt .75pt .75pt;height:1.5pt'></td> - </tr> -</table> - -<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","serif"'>� 1998 Microsoft -Corporation</span><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'> -<o:p></o:p></span></p> - -</div> - -</body> - -</html> diff --git a/general/perfcounters/kcs/kcs.htm b/general/perfcounters/kcs/kcs.htm deleted file mode 100644 index 4349388b..00000000 --- a/general/perfcounters/kcs/kcs.htm +++ /dev/null @@ -1,757 +0,0 @@ -<html xmlns:v="urn:schemas-microsoft-com:vml" -xmlns:o="urn:schemas-microsoft-com:office:office" -xmlns:w="urn:schemas-microsoft-com:office:word" -xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" -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 14"> -<meta name=Originator content="Microsoft Word 14"> -<link rel=File-List href="kcs_files/filelist.xml"> -<title>Sample Name</title> -<link rel=themeData href="kcs_files/themedata.thmx"> -<link rel=colorSchemeMapping href="kcs_files/colorschememapping.xml"> -<!--[if gte mso 9]><xml> - <w:WordDocument> - <w:Zoom>104</w:Zoom> - <w:SpellingState>Clean</w:SpellingState> - <w:GrammarState>Clean</w:GrammarState> - <w:TrackMoves>false</w:TrackMoves> - <w:TrackFormatting/> - <w:ValidateAgainstSchemas/> - <w:SaveIfXMLInvalid>false</w:SaveIfXMLInvalid> - <w:IgnoreMixedContent>false</w:IgnoreMixedContent> - <w:AlwaysShowPlaceholderText>false</w:AlwaysShowPlaceholderText> - <w:DoNotPromoteQF/> - <w:LidThemeOther>EN-US</w:LidThemeOther> - <w:LidThemeAsian>X-NONE</w:LidThemeAsian> - <w:LidThemeComplexScript>X-NONE</w:LidThemeComplexScript> - <w:Compatibility> - <w:BreakWrappedTables/> - <w:SplitPgBreakAndParaMark/> - </w:Compatibility> - <w:BrowserLevel>MicrosoftInternetExplorer4</w:BrowserLevel> - <m:mathPr> - <m:mathFont m:val="Cambria Math"/> - <m:brkBin m:val="before"/> - <m:brkBinSub m:val="--"/> - <m:smallFrac m:val="off"/> - <m:dispDef/> - <m:lMargin m:val="0"/> - <m:rMargin m:val="0"/> - <m:defJc m:val="centerGroup"/> - <m:wrapIndent m:val="1440"/> - <m:intLim m:val="subSup"/> - <m:naryLim m:val="undOvr"/> - </m:mathPr></w:WordDocument> -</xml><![endif]--><!--[if gte mso 9]><xml> - <w:LatentStyles DefLockedState="false" DefUnhideWhenUsed="false" - DefSemiHidden="false" DefQFormat="false" LatentStyleCount="267"> - <w:LsdException Locked="false" QFormat="true" Name="Normal"/> - <w:LsdException Locked="false" QFormat="true" Name="heading 1"/> - <w:LsdException Locked="false" QFormat="true" Name="heading 2"/> - <w:LsdException Locked="false" QFormat="true" Name="heading 3"/> - <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true" - QFormat="true" Name="heading 4"/> - <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true" - QFormat="true" Name="heading 5"/> - <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true" - QFormat="true" Name="heading 6"/> - <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true" - QFormat="true" Name="heading 7"/> - <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true" - QFormat="true" Name="heading 8"/> - <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true" - QFormat="true" Name="heading 9"/> - <w:LsdException Locked="false" SemiHidden="true" UnhideWhenUsed="true" - QFormat="true" Name="caption"/> - <w:LsdException Locked="false" QFormat="true" Name="Title"/> - <w:LsdException Locked="false" Priority="1" Name="Default Paragraph Font"/> - <w:LsdException Locked="false" QFormat="true" Name="Subtitle"/> - <w:LsdException Locked="false" QFormat="true" Name="Strong"/> - <w:LsdException Locked="false" QFormat="true" Name="Emphasis"/> - <w:LsdException Locked="false" Priority="99" Name="No List"/> - <w:LsdException Locked="false" Priority="99" SemiHidden="true" - Name="Placeholder Text"/> - <w:LsdException Locked="false" Priority="1" QFormat="true" Name="No Spacing"/> - <w:LsdException Locked="false" Priority="60" Name="Light Shading"/> - <w:LsdException Locked="false" Priority="61" Name="Light List"/> - <w:LsdException Locked="false" Priority="62" Name="Light Grid"/> - <w:LsdException Locked="false" Priority="63" Name="Medium Shading 1"/> - <w:LsdException Locked="false" Priority="64" Name="Medium Shading 2"/> - <w:LsdException Locked="false" Priority="65" Name="Medium List 1"/> - <w:LsdException Locked="false" Priority="66" Name="Medium List 2"/> - <w:LsdException Locked="false" Priority="67" Name="Medium Grid 1"/> - <w:LsdException Locked="false" Priority="68" Name="Medium Grid 2"/> - <w:LsdException Locked="false" Priority="69" Name="Medium Grid 3"/> - <w:LsdException Locked="false" Priority="70" Name="Dark List"/> - <w:LsdException Locked="false" Priority="71" Name="Colorful Shading"/> - <w:LsdException Locked="false" Priority="72" Name="Colorful List"/> - <w:LsdException Locked="false" Priority="73" Name="Colorful Grid"/> - <w:LsdException Locked="false" Priority="60" Name="Light Shading Accent 1"/> - <w:LsdException Locked="false" Priority="61" Name="Light List Accent 1"/> - <w:LsdException Locked="false" Priority="62" Name="Light Grid Accent 1"/> - <w:LsdException Locked="false" Priority="63" Name="Medium Shading 1 Accent 1"/> - <w:LsdException Locked="false" Priority="64" Name="Medium Shading 2 Accent 1"/> - <w:LsdException Locked="false" Priority="65" Name="Medium List 1 Accent 1"/> - <w:LsdException Locked="false" Priority="99" SemiHidden="true" Name="Revision"/> - <w:LsdException Locked="false" Priority="34" QFormat="true" - Name="List Paragraph"/> - <w:LsdException Locked="false" Priority="29" QFormat="true" Name="Quote"/> - <w:LsdException Locked="false" Priority="30" QFormat="true" - Name="Intense Quote"/> - <w:LsdException Locked="false" Priority="66" Name="Medium List 2 Accent 1"/> - <w:LsdException Locked="false" Priority="67" Name="Medium Grid 1 Accent 1"/> - <w:LsdException Locked="false" Priority="68" Name="Medium Grid 2 Accent 1"/> - <w:LsdException Locked="false" Priority="69" Name="Medium Grid 3 Accent 1"/> - <w:LsdException Locked="false" Priority="70" Name="Dark List Accent 1"/> - <w:LsdException Locked="false" Priority="71" Name="Colorful Shading Accent 1"/> - <w:LsdException Locked="false" Priority="72" Name="Colorful List Accent 1"/> - <w:LsdException Locked="false" Priority="73" Name="Colorful Grid Accent 1"/> - <w:LsdException Locked="false" Priority="60" Name="Light Shading Accent 2"/> - <w:LsdException Locked="false" Priority="61" Name="Light List Accent 2"/> - <w:LsdException Locked="false" Priority="62" Name="Light Grid Accent 2"/> - <w:LsdException Locked="false" Priority="63" Name="Medium Shading 1 Accent 2"/> - <w:LsdException Locked="false" Priority="64" Name="Medium Shading 2 Accent 2"/> - <w:LsdException Locked="false" Priority="65" Name="Medium List 1 Accent 2"/> - <w:LsdException Locked="false" Priority="66" Name="Medium List 2 Accent 2"/> - <w:LsdException Locked="false" Priority="67" Name="Medium Grid 1 Accent 2"/> - <w:LsdException Locked="false" Priority="68" Name="Medium Grid 2 Accent 2"/> - <w:LsdException Locked="false" Priority="69" Name="Medium Grid 3 Accent 2"/> - <w:LsdException Locked="false" Priority="70" Name="Dark List Accent 2"/> - <w:LsdException Locked="false" Priority="71" Name="Colorful Shading Accent 2"/> - <w:LsdException Locked="false" Priority="72" Name="Colorful List Accent 2"/> - <w:LsdException Locked="false" Priority="73" Name="Colorful Grid Accent 2"/> - <w:LsdException Locked="false" Priority="60" Name="Light Shading Accent 3"/> - <w:LsdException Locked="false" Priority="61" Name="Light List Accent 3"/> - <w:LsdException Locked="false" Priority="62" Name="Light Grid Accent 3"/> - <w:LsdException Locked="false" Priority="63" Name="Medium Shading 1 Accent 3"/> - <w:LsdException Locked="false" Priority="64" Name="Medium Shading 2 Accent 3"/> - <w:LsdException Locked="false" Priority="65" Name="Medium List 1 Accent 3"/> - <w:LsdException Locked="false" Priority="66" Name="Medium List 2 Accent 3"/> - <w:LsdException Locked="false" Priority="67" Name="Medium Grid 1 Accent 3"/> - <w:LsdException Locked="false" Priority="68" Name="Medium Grid 2 Accent 3"/> - <w:LsdException Locked="false" Priority="69" Name="Medium Grid 3 Accent 3"/> - <w:LsdException Locked="false" Priority="70" Name="Dark List Accent 3"/> - <w:LsdException Locked="false" Priority="71" Name="Colorful Shading Accent 3"/> - <w:LsdException Locked="false" Priority="72" Name="Colorful List Accent 3"/> - <w:LsdException Locked="false" Priority="73" Name="Colorful Grid Accent 3"/> - <w:LsdException Locked="false" Priority="60" Name="Light Shading Accent 4"/> - <w:LsdException Locked="false" Priority="61" Name="Light List Accent 4"/> - <w:LsdException Locked="false" Priority="62" Name="Light Grid Accent 4"/> - <w:LsdException Locked="false" Priority="63" Name="Medium Shading 1 Accent 4"/> - <w:LsdException Locked="false" Priority="64" Name="Medium Shading 2 Accent 4"/> - <w:LsdException Locked="false" Priority="65" Name="Medium List 1 Accent 4"/> - <w:LsdException Locked="false" Priority="66" Name="Medium List 2 Accent 4"/> - <w:LsdException Locked="false" Priority="67" Name="Medium Grid 1 Accent 4"/> - <w:LsdException Locked="false" Priority="68" Name="Medium Grid 2 Accent 4"/> - <w:LsdException Locked="false" Priority="69" Name="Medium Grid 3 Accent 4"/> - <w:LsdException Locked="false" Priority="70" Name="Dark List Accent 4"/> - <w:LsdException Locked="false" Priority="71" Name="Colorful Shading Accent 4"/> - <w:LsdException Locked="false" Priority="72" Name="Colorful List Accent 4"/> - <w:LsdException Locked="false" Priority="73" Name="Colorful Grid Accent 4"/> - <w:LsdException Locked="false" Priority="60" Name="Light Shading Accent 5"/> - <w:LsdException Locked="false" Priority="61" Name="Light List Accent 5"/> - <w:LsdException Locked="false" Priority="62" Name="Light Grid Accent 5"/> - <w:LsdException Locked="false" Priority="63" Name="Medium Shading 1 Accent 5"/> - <w:LsdException Locked="false" Priority="64" Name="Medium Shading 2 Accent 5"/> - <w:LsdException Locked="false" Priority="65" Name="Medium List 1 Accent 5"/> - <w:LsdException Locked="false" Priority="66" Name="Medium List 2 Accent 5"/> - <w:LsdException Locked="false" Priority="67" Name="Medium Grid 1 Accent 5"/> - <w:LsdException Locked="false" Priority="68" Name="Medium Grid 2 Accent 5"/> - <w:LsdException Locked="false" Priority="69" Name="Medium Grid 3 Accent 5"/> - <w:LsdException Locked="false" Priority="70" Name="Dark List Accent 5"/> - <w:LsdException Locked="false" Priority="71" Name="Colorful Shading Accent 5"/> - <w:LsdException Locked="false" Priority="72" Name="Colorful List Accent 5"/> - <w:LsdException Locked="false" Priority="73" Name="Colorful Grid Accent 5"/> - <w:LsdException Locked="false" Priority="60" Name="Light Shading Accent 6"/> - <w:LsdException Locked="false" Priority="61" Name="Light List Accent 6"/> - <w:LsdException Locked="false" Priority="62" Name="Light Grid Accent 6"/> - <w:LsdException Locked="false" Priority="63" Name="Medium Shading 1 Accent 6"/> - <w:LsdException Locked="false" Priority="64" Name="Medium Shading 2 Accent 6"/> - <w:LsdException Locked="false" Priority="65" Name="Medium List 1 Accent 6"/> - <w:LsdException Locked="false" Priority="66" Name="Medium List 2 Accent 6"/> - <w:LsdException Locked="false" Priority="67" Name="Medium Grid 1 Accent 6"/> - <w:LsdException Locked="false" Priority="68" Name="Medium Grid 2 Accent 6"/> - <w:LsdException Locked="false" Priority="69" Name="Medium Grid 3 Accent 6"/> - <w:LsdException Locked="false" Priority="70" Name="Dark List Accent 6"/> - <w:LsdException Locked="false" Priority="71" Name="Colorful Shading Accent 6"/> - <w:LsdException Locked="false" Priority="72" Name="Colorful List Accent 6"/> - <w:LsdException Locked="false" Priority="73" Name="Colorful Grid Accent 6"/> - <w:LsdException Locked="false" Priority="19" QFormat="true" - Name="Subtle Emphasis"/> - <w:LsdException Locked="false" Priority="21" QFormat="true" - Name="Intense Emphasis"/> - <w:LsdException Locked="false" Priority="31" QFormat="true" - Name="Subtle Reference"/> - <w:LsdException Locked="false" Priority="32" QFormat="true" - Name="Intense Reference"/> - <w:LsdException Locked="false" Priority="33" QFormat="true" Name="Book Title"/> - <w:LsdException Locked="false" Priority="37" SemiHidden="true" - UnhideWhenUsed="true" Name="Bibliography"/> - <w:LsdException Locked="false" Priority="39" SemiHidden="true" - UnhideWhenUsed="true" QFormat="true" Name="TOC Heading"/> - </w:LatentStyles> -</xml><![endif]--> -<style> -<!-- - /* Font Definitions */ - @font-face - {font-family:SimSun; - panose-1:2 1 6 0 3 1 1 1 1 1; - mso-font-alt:\5B8B\4F53; - mso-font-charset:134; - mso-generic-font-family:auto; - mso-font-pitch:variable; - mso-font-signature:3 680460288 22 0 262145 0;} -@font-face - {font-family:"Cambria Math"; - panose-1:2 4 5 3 5 4 6 3 2 4; - mso-font-charset:0; - mso-generic-font-family:roman; - mso-font-pitch:variable; - mso-font-signature:-536870145 1107305727 0 0 415 0;} -@font-face - {font-family:Tahoma; - 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:-520081665 -1073717157 41 0 66047 0;} -@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:-1593833729 1073750107 16 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;} -@font-face - {font-family:"\@SimSun"; - panose-1:2 1 6 0 3 1 1 1 1 1; - mso-font-charset:134; - mso-generic-font-family:auto; - mso-font-pitch:variable; - mso-font-signature:3 680460288 22 0 262145 0;} - /* Style Definitions */ - p.MsoNormal, li.MsoNormal, div.MsoNormal - {mso-style-unhide:no; - mso-style-qformat:yes; - mso-style-parent:""; - margin:0in; - margin-bottom:.0001pt; - mso-pagination:widow-orphan; - font-size:12.0pt; - font-family:"Times New Roman","serif"; - mso-fareast-font-family:"Times New Roman";} -h1 - {mso-style-unhide:no; - mso-style-qformat:yes; - mso-style-link:"Heading 1 Char"; - mso-style-next:Normal; - margin-top:12.0pt; - margin-right:0in; - margin-bottom:3.0pt; - margin-left:0in; - mso-pagination:widow-orphan; - page-break-after:avoid; - mso-outline-level:1; - font-size:16.0pt; - font-family:"Arial","sans-serif"; - mso-fareast-font-family:SimSun; - mso-fareast-theme-font:minor-fareast; - mso-font-kerning:16.0pt; - font-weight:bold;} -h2 - {mso-style-unhide:no; - mso-style-qformat:yes; - mso-style-link:"Heading 2 Char"; - 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","serif"; - mso-fareast-font-family:SimSun; - mso-fareast-theme-font:minor-fareast; - font-weight:bold;} -h3 - {mso-style-unhide:no; - mso-style-qformat:yes; - mso-style-link:"Heading 3 Char"; - 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","serif"; - mso-fareast-font-family:SimSun; - mso-fareast-theme-font:minor-fareast; - font-weight:bold;} -p.MsoCommentText, li.MsoCommentText, div.MsoCommentText - {mso-style-noshow:yes; - mso-style-unhide:no; - mso-style-link:"Comment Text Char"; - margin:0in; - margin-bottom:.0001pt; - mso-pagination:widow-orphan; - font-size:10.0pt; - font-family:"Times New Roman","serif"; - mso-fareast-font-family:"Times New Roman";} -span.MsoCommentReference - {mso-style-noshow:yes; - mso-style-unhide:no; - mso-ansi-font-size:8.0pt; - mso-bidi-font-size:8.0pt;} -a:link, span.MsoHyperlink - {mso-style-unhide:no; - color:blue; - text-decoration:underline; - text-underline:single;} -a:visited, span.MsoHyperlinkFollowed - {mso-style-unhide:no; - color:blue; - text-decoration:underline; - text-underline:single;} -p - {mso-style-unhide:no; - 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","serif"; - mso-fareast-font-family:"Times New Roman";} -p.MsoCommentSubject, li.MsoCommentSubject, div.MsoCommentSubject - {mso-style-noshow:yes; - mso-style-unhide:no; - mso-style-parent:"Comment Text"; - mso-style-link:"Comment Subject Char"; - mso-style-next:"Comment Text"; - margin:0in; - margin-bottom:.0001pt; - mso-pagination:widow-orphan; - font-size:10.0pt; - font-family:"Times New Roman","serif"; - mso-fareast-font-family:"Times New Roman"; - font-weight:bold;} -p.MsoAcetate, li.MsoAcetate, div.MsoAcetate - {mso-style-noshow:yes; - mso-style-unhide:no; - mso-style-link:"Balloon Text Char"; - margin:0in; - margin-bottom:.0001pt; - mso-pagination:widow-orphan; - font-size:8.0pt; - font-family:"Tahoma","sans-serif"; - mso-fareast-font-family:"Times New Roman";} -span.Heading1Char - {mso-style-name:"Heading 1 Char"; - mso-style-unhide:no; - mso-style-locked:yes; - mso-style-link:"Heading 1"; - mso-ansi-font-size:14.0pt; - mso-bidi-font-size:14.0pt; - font-family:"Cambria","serif"; - mso-ascii-font-family:Cambria; - mso-ascii-theme-font:major-latin; - mso-fareast-font-family:SimSun; - mso-fareast-theme-font:major-fareast; - mso-hansi-font-family:Cambria; - mso-hansi-theme-font:major-latin; - mso-bidi-font-family:"Times New Roman"; - mso-bidi-theme-font:major-bidi; - color:#365F91; - mso-themecolor:accent1; - mso-themeshade:191; - font-weight:bold;} -span.Heading2Char - {mso-style-name:"Heading 2 Char"; - mso-style-unhide:no; - mso-style-locked:yes; - mso-style-link:"Heading 2"; - mso-ansi-font-size:13.0pt; - mso-bidi-font-size:13.0pt; - font-family:"Cambria","serif"; - mso-ascii-font-family:Cambria; - mso-ascii-theme-font:major-latin; - mso-fareast-font-family:SimSun; - mso-fareast-theme-font:major-fareast; - mso-hansi-font-family:Cambria; - mso-hansi-theme-font:major-latin; - mso-bidi-font-family:"Times New Roman"; - mso-bidi-theme-font:major-bidi; - color:#4F81BD; - mso-themecolor:accent1; - font-weight:bold;} -span.Heading3Char - {mso-style-name:"Heading 3 Char"; - mso-style-unhide:no; - mso-style-locked:yes; - mso-style-link:"Heading 3"; - mso-ansi-font-size:12.0pt; - mso-bidi-font-size:12.0pt; - font-family:"Cambria","serif"; - mso-ascii-font-family:Cambria; - mso-ascii-theme-font:major-latin; - mso-fareast-font-family:SimSun; - mso-fareast-theme-font:major-fareast; - mso-hansi-font-family:Cambria; - mso-hansi-theme-font:major-latin; - mso-bidi-font-family:"Times New Roman"; - mso-bidi-theme-font:major-bidi; - color:#4F81BD; - mso-themecolor:accent1; - font-weight:bold;} -span.CommentTextChar - {mso-style-name:"Comment Text Char"; - mso-style-unhide:no; - mso-style-locked:yes; - mso-style-link:"Comment Text";} -span.CommentSubjectChar - {mso-style-name:"Comment Subject Char"; - mso-style-unhide:no; - mso-style-locked:yes; - mso-style-parent:"Comment Text Char"; - mso-style-link:"Comment Subject"; - font-weight:bold;} -span.BalloonTextChar - {mso-style-name:"Balloon Text Char"; - mso-style-unhide:no; - mso-style-locked:yes; - mso-style-link:"Balloon Text"; - mso-ansi-font-size:8.0pt; - mso-bidi-font-size:8.0pt; - font-family:"Tahoma","sans-serif"; - mso-ascii-font-family:Tahoma; - mso-hansi-font-family:Tahoma; - mso-bidi-font-family:Tahoma;} -span.SpellE - {mso-style-name:""; - mso-spl-e:yes;} -span.GramE - {mso-style-name:""; - mso-gram-e:yes;} -.MsoChpDefault - {mso-style-type:export-only; - mso-default-props:yes; - font-size:10.0pt; - mso-ansi-font-size:10.0pt; - mso-bidi-font-size:10.0pt;} -@page WordSection1 - {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.WordSection1 - {page:WordSection1;} - /* List Definitions */ - @list l0 - {mso-list-id:572357372; - mso-list-template-ids:266362772;} -@list l0:level1 - {mso-level-tab-stop:.5in; - mso-level-number-position:left; - text-indent:-.25in;} -@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;} -@list l1 - {mso-list-id:1790778369; - mso-list-template-ids:266362772;} -@list l1:level1 - {mso-level-tab-stop:.5in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l1:level2 - {mso-level-tab-stop:1.0in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l1:level3 - {mso-level-tab-stop:1.5in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l1:level4 - {mso-level-tab-stop:2.0in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l1:level5 - {mso-level-tab-stop:2.5in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l1:level6 - {mso-level-tab-stop:3.0in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l1:level7 - {mso-level-tab-stop:3.5in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l1:level8 - {mso-level-tab-stop:4.0in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l1: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-priority:99; - 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","serif";} -</style> -<![endif]--><!--[if gte mso 9]><xml> - <o:shapedefaults v:ext="edit" spidmax="1026"/> -</xml><![endif]--><!--[if gte mso 9]><xml> - <o:shapelayout v:ext="edit"> - <o:idmap v:ext="edit" data="1"/> - </o:shapelayout></xml><![endif]--> -</head> - -<body lang=EN-US link=blue vlink=blue style='tab-interval:.5in'> - -<div class=WordSection1> - -<h2><span style='font-family:"Verdana","sans-serif";mso-fareast-font-family: -"Times New Roman"'>Kernel Counter Sample (<span class=SpellE>Kcs</span>)<o:p></o:p></span></h2> - -<h3><span style='font-family:"Verdana","sans-serif";mso-fareast-font-family: -"Times New Roman"'>SUMMARY<o:p></o:p></span></h3> - -<p class=MsoNormal><span class=SpellE><span class=GramE>kcs</span></span> is a -sample to demonstrate the use of kernel mode <span class=SpellE>perflib</span> -API. The driver does not control any hardware; it simple provides counters. The -code contains comments to explain what each function does. </p> - -<h3><span style='font-family:"Verdana","sans-serif";mso-fareast-font-family: -"Times New Roman"'>USING THE SAMPLE<o:p></o:p></span></h3> - -<p class=MsoNormal>To test the <span class=SpellE>Kcs</span> counter provider, -use the following procedure.</p> - -<ol start=1 type=1> - <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; - mso-list:l1 level1 lfo1;tab-stops:list .5in'>Copy<i style='mso-bidi-font-style: - normal'> kcs.sys </i>and<i style='mso-bidi-font-style:normal'> <span - class=SpellE>kcs.man</span> </i>files in <span class=GramE>%<span - class=SpellE>windir</span>%\system32 <span class=SpellE>dir</span>, and <span - class=SpellE><i style='mso-bidi-font-style:normal'>kcs.sys.mui</i></span><i - style='mso-bidi-font-style:normal'> </i>in %<span class=SpellE>windir</span>%\system32\en-US</span> - <span class=SpellE>dir</span> if <span class=SpellE><i style='mso-bidi-font-style: - normal'>kcs.sys.mui</i></span><i style='mso-bidi-font-style:normal'> </i>was - generated. <br style='mso-special-character:line-break'> - <![if !supportLineBreakNewLine]><br style='mso-special-character:line-break'> - <![endif]></li> - <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; - mso-list:l1 level1 lfo1;tab-stops:list .5in'>Sign the sample driver. For - details about how to sign the driver, see "SIGNNING THE SAMPLE - DRIVER" section. <br style='mso-special-character:line-break'> - <![if !supportLineBreakNewLine]><br style='mso-special-character:line-break'> - <![endif]></li> - <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; - mso-list:l1 level1 lfo1;tab-stops:list .5in'>Install the counters.</li> -</ol> - -<p class=MsoNormal style='margin-left:1.0in'><span style='font-size:10.0pt; -font-family:"Courier New"'>lodctr.exe /<span class=SpellE>m<span class=GramE>:kcs.man</span></span><o:p></o:p></span></p> - -<ol start=4 type=1> - <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; - mso-list:l1 level1 lfo1;tab-stops:list .5in'>Create a service to control - the driver.</li> -</ol> - -<p class=MsoNormal style='margin-left:1.0in'><span class=SpellE><span -class=GramE><span style='font-size:10.0pt;font-family:"Courier New"'>sc</span></span></span><span -style='font-size:10.0pt;font-family:"Courier New"'> create <span class=SpellE>kcs</span> -<span class=SpellE>binpath</span>= %<span class=SpellE>windir</span>%\system32\kcs.sys -type= kernel start= demand<o:p></o:p></span></p> - -<ol start=5 type=1> - <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; - mso-list:l1 level1 lfo1;tab-stops:list .5in'>Start the service</li> -</ol> - -<p class=MsoNormal style='margin-left:1.0in'><span class=GramE><span -style='font-size:10.0pt;font-family:"Courier New"'>net</span></span><span -style='font-size:10.0pt;font-family:"Courier New"'> start <span class=SpellE>kcs</span><o:p></o:p></span></p> - -<ol start=6 type=1> - <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; - mso-list:l1 level1 lfo1;tab-stops:list .5in'>Run <span class=SpellE>perfmon</span> - and add Geometric Wave and <span class=SpellE>Trignometric</span> Wave - Counter Sets</li> -</ol> - -<p class=MsoNormal style='margin-left:1.0in'><span style='font-size:10.0pt; -font-family:"Courier New"'>perfmon.exe<o:p></o:p></span></p> - -<ol start=7 type=1> - <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; - mso-list:l1 level1 lfo1;tab-stops:list .5in'>To stop the service, run</li> -</ol> - -<p class=MsoNormal style='margin-left:1.0in'><span class=GramE><span -style='font-size:10.0pt;font-family:"Courier New"'>net</span></span><span -style='font-size:10.0pt;font-family:"Courier New"'> stop <span class=SpellE>kcs</span><o:p></o:p></span></p> - -<ol start=8 type=1> - <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; - mso-list:l1 level1 lfo1;tab-stops:list .5in'>To un-install the counters, - run</li> -</ol> - -<p class=MsoNormal style='margin-left:1.0in'><span style='font-size:10.0pt; -font-family:"Courier New"'>unlodctr.exe /<span class=SpellE>m<span class=GramE>:kcs.man</span></span><o:p></o:p></span></p> - -<h3><span style='font-family:"Verdana","sans-serif";mso-fareast-font-family: -"Times New Roman"'>BUILD THE SAMPLE<o:p></o:p></span></h3> - -<p class=MsoNormal>To get the simple driver (kcs.sys), use the following -procedure.</p> - -<ol start=1 type=1> - <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; - mso-list:l0 level1 lfo2;tab-stops:list .5in'>Click <span class=SpellE>kcs.vcxproj</span> - to open the sample.</li> - <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; - mso-list:l0 level1 lfo2;tab-stops:list .5in'>Right click project, select - Properties, <span class=SpellE>goto</span> Linker -> Manifest File, <span - class=GramE>make</span> sure "<span style='mso-fareast-font-family: - SimSun'>Generate Manifest</span>" is "No".</li> - <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto; - mso-list:l0 level1 lfo2;tab-stops:list .5in'>Build the project.</li> - <ol start=1 type=1> - <li class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt: - auto;mso-list:l0 level2 lfo2;tab-stops:list 1.0in'>You can press "F7" - or choose Build->Build Solution.</li> - </ol> -</ol> - -<h3><span style='font-family:"Verdana","sans-serif";mso-fareast-font-family: -"Times New Roman"'>LIMITATIONS<o:p></o:p></span></h3> - -<p class=MsoNormal>This sample driver should not be used in a production -environment. </p> - -<p class=MsoNormal><o:p> </o:p></p> - -<p class=MsoNormal><span class=SpellE>Kcs</span> is designed for Windows 7 -and later versions of Windows. </p> - -<p class=MsoNormal><o:p> </o:p></p> - -<h3><span style='font-family:"Verdana","sans-serif";mso-fareast-font-family: -"Times New Roman"'>FILE LIST<o:p></o:p></span></h3> - -<p class=MsoNormal><span class=SpellE>kcs.h</span></p> - -<p class=MsoNormal><span class=SpellE><span class=GramE>makefile</span></span></p> - -<p class=MsoNormal><span class=GramE>sources</span></p> - -<p class=MsoNormal><span class=SpellE>kcs.c</span></p> - -<p class=MsoNormal><span class=SpellE>kcs.rc</span></p> - -<p class=MsoNormal><o:p> </o:p></p> - -<h3><span style='font-family:"Verdana","sans-serif";mso-fareast-font-family: -"Times New Roman"'>LOCATION<o:p></o:p></span></h3> - -<p class=MsoNormal>The files that comprise <span class=SpellE>Kcs</span> are -included in the Windows DDK in the \<span class=SpellE>src</span>\general\<span -class=SpellE>perfcounters</span>\<span class=SpellE>kcs</span> directory.</p> - -<h3><span style='font-family:"Verdana","sans-serif";mso-fareast-font-family: -"Times New Roman"'><o:p> </o:p></span></h3> - -<h3><span style='font-family:"Verdana","sans-serif";mso-fareast-font-family: -"Times New Roman"'>FEEDBACK<o:p></o:p></span></h3> - -<p align=center style='text-align:center'><span style='font-size:10.0pt; -font-family:"Verdana","sans-serif"'><a href="kcs.htm#top">Top of page</a> <o:p></o:p></span></p> - -<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0 width=624 - style='width:6.5in;mso-cellspacing:0in;mso-yfti-tbllook:1184;mso-padding-alt: - 0in 5.4pt 0in 5.4pt'> - <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes; - height:1.5pt'> - <td style='background:aqua;padding:.75pt .75pt .75pt .75pt;height:1.5pt'> - <p class=MsoNormal><span style='font-size:2.0pt;mso-bidi-font-size:12.0pt'><o:p> </o:p></span></p> - </td> - </tr> -</table> - -<p><span style='font-size:7.5pt;font-family:"MS Sans Serif","serif"'>� -Microsoft Corporation</span><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'> -<o:p></o:p></span></p> - -</div> - -</body> - -</html> diff --git a/general/toaster/toastpkg/toastpkg.htm b/general/toaster/toastpkg/toastpkg.htm deleted file mode 100644 index cd780261..00000000 --- a/general/toaster/toastpkg/toastpkg.htm +++ /dev/null @@ -1,186 +0,0 @@ -<HTML> -<HEAD> -<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=windows- -1252"> -<META NAME="Generator" CONTENT="Microsoft Word 97"> -<TITLE>Toaster Installation Package</TITLE> -</HEAD> -<BODY LINK="#0000ff"> - -<FONT FACE="Verdana" SIZE=5><H2>Toaster Installation Package</H2> -</FONT><FONT FACE="Verdana" SIZE=2> - - -<H3>SUMMARY</H3></FONT><FONT FACE="Verdana" SIZE=2><P> -This document discusses the different approaches that end users take when adding new hardware to their computer, and describes an approach that addresses these scenarios in a consistent, robust manner that works cooperatively with Plug and Play in Windows 2000 and Windows XP. It also outlines the mechanisms provided to facilitate additional vendor requirements such as the installation of value-added software. - -<H3>INTRODUCTION</H3></FONT><FONT FACE="Verdana" SIZE=2><P> -The installation of software to support an instance of a given device (known as "device installation" or "driver installation") is done in a device-centric fashion in Windows operating systems. A device INF that matches up with one of the device's hardware or compatible IDs is used to identify the required driver file(s), registry modifications, etc., that are needed to make the device fully operational. This INF, along with the files copied thereby and a catalog that contains the digital signatures of the INF and these other files, constitute what is known as a "driver package". - -<p> -Because device installation is done for a specific instance of a device, the "natural" method of adding devices to a computer running a Plug and Play operating system is by plugging in the device first, letting Plug and Play find the device and automatically initiate an installation for that device. The device installation may then proceed using a driver package supplied with the OS, or a "3rd-party" driver package (supplied via CD-ROM, the Internet, or some other distribution mechanism). When the device installation is initiated by the addition of hardware, this is termed a "hardware-first" device -installation. - -<p> -Users may, however, take an alternate approach to adding hardware to their computer. In this scenario, they first run a setup program (perhaps launched as an autorun application when the vendor-supplied CD-ROM is inserted). This setup program may perform installation activities, and then prompt the user to insert their hardware. Upon the hardware's insertion, the vendor-supplied driver package (which was "pre-installed" by the setup program) is then found by Plug and Play, and the installation proceeds as in the hardware-first scenario. When the device installation is initiated by running a setup program, this is termed a "software-first" device installation. This approach to adding new hardware is just as valid as the hardware-first scenario, and some vendors may even instruct their users (via documentation that ships with the hardware) that this is the preferred method. - -<p> -Vendors must support the hardware-first scenario (by providing a driver package that may be supplied to the "Found New Hardware" wizard with no -"pre-configuration" performed by a setup program or other mechanism). Vendors may optionally support the software-first scenario as well, but the -actual installation of the device instance is done by Plug and Play upon the device's arrival, as described above. - -<p> -Vendors may also wish to perform additional activities as part of the device installation. For example, the vendor may want to allow the user to optionally install one or more applications that ship with the device (e.g., a scanner that ships with an image processing application). Such software is termed "value-added software". Value-added software is distinct from the files that comprise the driver package because, unlike the core driver files, the device does not require value-added software to function properly. In the previous example of a scanner, for instance, perhaps the user already has an image processing application that they prefer. The user should be given the option of whether or not they want to install any value-added software. Additional activities (such as allowing the user to select value-added software offerings) may be accomplished by using a vendor-supplied -device-specific co-installer. - - -<H3>INTRODUCTION TO THE TOASTER INSTALLATION SAMPLE</H3></FONT><FONT FACE="Verdana" SIZE=2><P> -This sample contains <B>inf, toastapp, toastcd, toastco, </B> and<B> toastva</B> directories. The following summary describes the directories and key files. -<P> - -<I>inf</I> -<BLOCKQUOTE> -This directory contains the device INF (<B>toastpkg.inf</B>) that is used in device installation of toaster devices enumerated by the toaster bus enumerator. It registers a device-specific co-installer (<B>tostrco2.dll</B>) that provides additional functionality during the installation. - -<p> -Also contained in this directory is the <B>autorun.inf</B> file that would be placed in the root of the vendor's setup media (e.g., CD-ROM). This INF will launch the <B>toastva.exe</B> application (described below) when the media is inserted in an autorun-capable drive, or when the user double-clicks on the drive icon in Explorer. Additionally, this INF illustrates the [DeviceInstall] section that is a new feature introduced in Windows XP for -autorun INF files: - -<BLOCKQUOTE> -<p> -[DeviceInstall] -<p> -DriverPath=\ -</BLOCKQUOTE> - -<p> -The DriverPath entry in a [DeviceInstall] section indicates to the Found New Hardware and Update Driver wizards that Plug and Play should search for -device INFs in the specified directory only. This provides a performance improvement for media layouts that contain many subdirectories, since the default -behavior is for Plug and Play to recursively search the entire CD. Additionally, specifying no DriverPath entry in this section indicates that the CD contains no drivers, thus Plug and Play can quickly determine that it can ignore this media. Absence of the [DeviceInstall] section will cause the media to be treated as it was in previous versions of Windows (e.g., as in Windows Me and Windows 2000, the entire media will be searched recursively for applicable INFs). -</BLOCKQUOTE> - -<I>toastapp</I> <BLOCKQUOTE> -This directory contains the source code for the <B>toastapp.exe</B> program that is used as value-added software that may optionally be installed by the user as part of device installation. This program is installed via the InstallShield(tm) (Microsoft Installer-based) setup program in the <I>toastcd\ToastApp</I> directory. -</BLOCKQUOTE> - -<I>toastcd</I> <BLOCKQUOTE> -This directory contains the CD image that would be used by the vendor to distribute the toaster package. In the root of the image, we have the -<B>autorun.inf</B> which launches either the x86 or ia64 version of <B>toastva.exe</B> (depending on platform). Also in the root we have the device INF, -<B>toastpkg.inf</B>, and the two associated catalogs, <B>tostx86.cat</B> and <B>tostia64.cat</B>, for the x86 and ia64 platforms respectively. Finally, -in the root we also have the zero-length tag file <B>toastpkg.tag</B>, which is used to identify the media in case it must be prompted for. This tagfile is -referenced in the <I>SourceDisksNames</I> sections of <B>toastpkg.inf</B>: - -<BLOCKQUOTE> -<p> -[SourceDisksNames.x86] -<p> -1 = %DiskId1%, toastpkg.tag,,\i386 -<p> -[SourceDisksNames.ia64] -<p> -1 = %DiskId1%, toastpkg.tag,,\ia64 -</BLOCKQUOTE> - -<p> -The i386 and ia64 subdirectories contain the driver files that, along with the INF and CAT, constitute the driver package. These files are -<B>toaster.sys</B>, <B>tostrcls.dll</B>, and <B>tostrco2.dll</B>. Their corresponding debug (.PDB) files are located there as well, although -these aren�t installed. Additionally, as mentioned above, the <B>toastva.exe</B> program (and its .PDB file) is located here. Note that this -is not part of the driver package�it is merely used to facilitate software-first installation. Since this executable is not part of the driver -package, it may be modified without affecting the digital signature of the package. - -<p> -Finally, the <I>ToastApp</I> subdirectory contains the <B>setup.exe</B> program that installs the value-added software package, <B>toastapp.exe</B>. This -<B>setup.exe</B> is a standalone package that contains the files it installs within this single binary. This is meant to represent an example of the kind -of software that might be supplied to a vendor by an ISV for distribution with that vendor's hardware. While this particular setup program was authored -with InstallShield(tm), other installation methods are equally valid. For example, the setup program could have been written using C/C++, directly -leveraging the Microsoft Installer (MSI) application programming interfaces (API). - -<p> -The <B>tostrco2.dll</B> module is constructed so that there is no requirement on how the value-added software is installed--it simply creates a process to initiate the setup program, then waits for that process to terminate before continuing. For the sample, the description of the value-added software offerings and details of launching the value-added setup application are hard-coded, but in a real-world scenario, the value-added software supplied might be listed in some sort of data file (perhaps an INF file) and the value-added software selection page would be completely data driven, using the information contained in that data file. This would be advantageous, for example, because a vendor could submit just their core driver package for Windows Logo testing without any value-added software (and without this data file). The vendor could then construct setup media containing the core driver package plus value-added software as they see fit. The contents of their setup media could be modified at any time by adding or removing value-added software, and no changes to the core driver package would be required (hence, no need to re-submit for Windows Logo testing). This works because the data file containing details about the -value-added software offerings isn't a part of the driver package, and thus can be changed without affecting that package. A co-installer DLL written -to accommodate such a scheme could have default behavior that would not display the value-added software selection page in the absence of this data file. -</BLOCKQUOTE> - -<I>toastco</I> <BLOCKQUOTE> -This directory contains the co-installer, <B>tostrco2.dll</B>, which is used during device installation of toaster devices enumerated by the toaster bus enumerator. This co-installer supplies a finish-install wizard page that allows the user to select the value-added software, if any, that they wish to install. It does not supply a finish-install wizard page if the user has previously responded to the wizard page (whether or not they opted to install value-added software) so that the user isn't prompted multiple times in the case where they plug in multiple toasters (or the same toaster is plugged into multiple ports, which will appear to Plug and Play as different instances of that device). - -<p> -This DLL also supplies the same value-added software selection page for use by the <B>toastva.exe</B> setup program. This avoids code duplication and ensures a consistent user experience for the hardware-first and software-first scenarios. - -<p> -Finally, this co-installer performs the same function as its version 1 counterpart (in the <I>coinstaller</I> directory under the main toaster directory). It provides a friendly name for the device that incorporates its serial number. However, this version retrieves the friendly name template from the INF, and since the template is stored in the [Strings] section, it may be localized for other languages. - -<p> -The reason this co-installer�s filename includes version number is to illustrate the technique that must be used when updating the driver for a device that may already have a previous version of the co-installer installed. If the name is not changed, then the old co-installer will be loaded early-on during the processing of DIF codes, and the updated version won�t be able to �get in the loop� to perform its new actions when installing the device. Thus, co-installers should include a version number in their filename, so that the new version can be copied and can participate in the device installation. - </BLOCKQUOTE> - -<I>toastva</I> <BLOCKQUOTE> -This directory contains the autorun installation application, <B>toastva.exe</B>, which is launched when the user inserts the vendor-provided CD-ROM. This application is used to "pre-install" the necessary INF and catalog, along with any value-added software the user chooses. In addition, it uses the <B>UpdateDriverForPlugAndPlayDevices</B> API to update the existing installed drivers for any toasters that may already be present. Examples of scenarios where this would apply are: -<OL> -<LI> -The user previously plugged in a toaster, and there was no in-box support (i.e., no supporting driver was included with Windows) for it. The user didn't supply a vendor provided driver package at that time (perhaps because they didn't have the media), so no driver was installed for the device (this is sometimes referred to as a "null driver install"). -<LI> -The user previously plugged in a toaster, and there was in-box support for it (perhaps using an older or reduced-functionality driver). -<LI> -The user previously plugged in a toaster, and at that time supplied an older version of the driver provided by the vendor. -</UL> -<P> -In all the above cases, the <B>UpdateDriverForPlugAndPlayDevices</B> API will seek out any toaster device instances matching the specified hardware or compatible ID, and determine whether the specified driver package is "better" (i.e., lower rank or newer). If so, the device instance will be updated with the specified driver package. -</BLOCKQUOTE> - -<H3>BUILDING THE SAMPLE</H3></FONT><FONT FACE="Verdana" -SIZE=2><P> -To build the Toaster Installation Sample components, you must first set up the DDK environment on your host machine. The �Installation and Release Notes� -topic in the Windows XP DDK has a complete description on how to do this. - -<P> -Run the build �cZ command in the <I>toastpkg</I> directory to build <B>tostrco2.dll</B>, <B>toastapp.exe</B>, and <B>toastva.exe</B>. Run the build �cZ -command in the <I>classinstaller</I> and <I>func</I> subdirectories of the main <I>Toaster</I> directory (parent of the <I>toastpkg</I> directory) to build -<B>tostrcls.dll</B> and <B>toaster.sys</B>. The <I>toastcd</I> directory contains all these components already built with full debugging information. The -reason is so that the sample could be digitally signed (thus exactly reproducing the ideal user experience). - -<P> -To experiment with certain behaviors of this package (e.g., <B>toastva.exe</B> launched via CD autorun), it is necessary to copy the entire contents of the <I>toastcd</I> tree onto a writeable CD. -<P> - -<H3>RUNNING THE SAMPLE</H3></FONT><FONT FACE="Verdana" SIZE=2><P> -The sample can be run in two different ways, corresponding to the hardware-first and software-first scenarios. -<P> -<B>Hardware-First Device Installation Walk-Through</B> -<P> -Simulate the plugging in of a toaster by typing the following at a command prompt (see the documentation for the toaster sample driver for more information on setting up the toaster bus enumerator and using the "enum" application to simulate plugging and unplugging of toaster devices): - -<BLOCKQUOTE> -<P> -C:\>enum -p 1 -</BLOCKQUOTE> - -<P> -Since there is no in-box driver for this device, the Found New Hardware wizard will appear, prompting for a driver package. If you constructed the setup image on autorun-capable media (e.g., writeable CD or DVD), you may insert that media in the drive, and Windows XP will automatically initiate a driver search on that media. On Windows 2000, you must click "Next" to initiate the driver search on that media. If you constructed the setup image in a directory on your hard disk, then you must click the "Install from a list or specific location (Advanced)" radio button, then click "Next". On the next page, click the "Include this location in the search:" checkbox, and type the path to the directory. Clicking "Next" will then initiate a driver search in the directory you specified. - -<P> -The install will proceed using the <B>toastpkg.inf </B>file in the root of the install location. The co-installer, <B>tostrco2.dll</B>, will assign the device a friendly name during <B>DIF_INSTALLDEVICE</B>, and will supply a value-add software selection wizard page in response to <B>DIF_NEWDEVICEWIZARD_FINISHINSTALL</B>. This page will only be supplied if the user hasn�t been given the option previously of selecting value-added software (of if they�ve since uninstalled said software). This allows subsequent toasters to be installed server-side, without any user interaction whatsoever (even if a non-admin user or no user is logged in). - -<P> -<B>Software-First Device Installation Walk-Through</B> -<P> -If you constructed the setup image on auto-run capable media (e.g., writeable CD or DVD), you can simply insert the media, and the <B>toastva.exe</B> program will automatically launch. Note that <B>toastva.exe</B> suppresses itself when invoked while a device installation is in progress, which is why this application doesn�t appear during the hardware-first scenario described above. - -<P> -After the Welcome page, the wizard will attempt to update the driver for any existing toaster devices (via the <B>UpdateDriverForPlugAndPlayDevices</B>) API. -If there aren�t any, it will instead �pre-install� the INF using the <B>SetupCopyOEMInf</B> API so that Plug and Play will automatically find a match when -the hardware is subsequently inserted. <B>SetupCopyOEMInf</B> also stores away information that allows Plug and Play to know where the INF came from, thus allowing the Found New Hardware wizard to prompt for media in the correct location if it ever needs to. In this scenario, it is presumed that the user will plug in their toaster upon completion of the wizard, when they�re instructed to do so. As such, they should never actually be prompted to reinsert the CD, since they wouldn�t have removed it. However, if they had removed it, Plug and Play would prompt them to reinsert it. It is possible to �pre-install� all the driver files as well so that the user would never be prompted, even if they did remove the CD. The Windows XP DDK has a discussion of this technique in the section titled �Writing a Device Installation Application� in the Device Installation chapter. - -<P> -Next, the wizard displays the same value-add software selection page as the user would receive if they�d performed a hardware-first install, as described above. After clicking �Next� on this page, any selected applications are installed (the wizard is hidden while these setup processes run), then the Finish wizard page appears. If the wizard didn�t find any devices during its call to <B>UpdateDriverForPlugAndPlayDevices</B>, it prompts the user to plug in their hardware now. When the user does plug in the hardware (i.e., by typing �enum �p 1� as described above), then the install will proceed without requiring any user interaction. - -<H3>FEEDBACK</H3> - <P>We welcome your comments, problem reports and wish-list requests. Please - submit them by pointing your Internet browser to <A - href="http://www.microsoft.com/whdc/default.mspx">http://www.microsoft.com/whdc/default.mspx</A>. -</P> - - -<P> -<FONT FACE="MS Sans Serif" SIZE=1><P>© 2005 Microsoft Corporation</FONT><FONT FACE="Verdana" SIZE=2> </P></FONT></BODY> -</HTML> diff --git a/general/tracing/evntdrv/evntdrv.htm b/general/tracing/evntdrv/evntdrv.htm deleted file mode 100644 index 0d89619d..00000000 --- a/general/tracing/evntdrv/evntdrv.htm +++ /dev/null @@ -1,189 +0,0 @@ -<html> - -<head> -<meta http-equiv=Content-Type content="text/html; charset=windows-1252"> -<meta name=Generator content="Microsoft Word 12 (filtered)"> -<title>Eventdrv</title> -<style> -<!-- - /* Font Definitions */ - @font-face - {font-family:"Cambria Math"; - panose-1:2 4 5 3 5 4 6 3 2 4;} - /* Style Definitions */ - p.MsoNormal, li.MsoNormal, div.MsoNormal - {margin:0in; - margin-bottom:.0001pt; - font-size:12.0pt; - font-family:"Times New Roman","serif";} -.MsoChpDefault - {font-size:10.0pt;} -@page Section1 - {size:8.5in 11.0in; - margin:1.0in 1.0in 1.0in 1.0in;} -div.Section1 - {page:Section1;} ---> -</style> - -<meta http-equiv=Content-Language content=en-us> -</head> - -<body lang=EN-US> - -<div class=Section1> - -<div style='left:12px;position:absolute;top:-30px'> - -<div u1:shape="_x0000_s1030"> - -<p class=MsoNormal> </p> - -<p class=MsoNormal><b><span lang=EN style='font-size:16.0pt'>Eventdrv<u2:p></u2:p></span></b></p> - -<p class=MsoNormal><b><span lang=EN style='font-size:14.0pt'>Summary</span></b></p> - -<u2:p></u2:p> - -<p class=MsoNormal><span lang=EN>Eventdrv is a sample kernel mode trace -provider/driver. The driver does not control any hardware; it simply generates -trace events. It is designed to demonstrate the use of ETW tracing in a driver.<u2:p></u2:p></span></p> - -<p class=MsoNormal><span lang=EN>Eventdrv registers as a provider by calling -the EtwRegister API. If successful, it logs a StartEvent event with the -device�s name, the length of the name, and the status code. Then, when it -receives a DeviceIOControl call, it logs a SampleEventA event. Finally, when -the driver gets unloaded, it logs an UnloadEvent event with a pointer to the -device object.<u2:p> Note that Windows Pre-Processor (WPP) Tracing tools such -as TraceView.exe cannot be used to start/stop and view traces.</u2:p></span></p> - -<p class=MsoNormal><span lang=EN> <u2:p></u2:p></span></p> - -<p class=MsoNormal><b><span lang=EN style='font-size:14.0pt'>Using the Sample</span></b></p> - -<u2:p></u2:p> - -<p class=MsoNormal><span lang=EN style='font-size:14.0pt'> </span><span -lang=EN>To test the Eventdrv event tracing provider, use the following -procedure:<u2:p></u2:p></span></p> - -<p class=MsoNormal style='margin-left:.25in;text-indent:-.25in'><span lang=EN -style='color:black'>1.</span> <span lang=EN>Build the Eventdrv sample -driver (in evntdrv\Eventdrv) by using the -cZg switch.</span></p> - -<p class=MsoNormal style='margin-left:.25in;text-indent:-.25in'>2. -Install the manifest located in the evntdrv\Eventdrv folder by using the -following command:</p> - -<p class=MsoNormal style='margin-left:.25in;text-indent:-.25in'> -wevtutil im evntdrv.xml<br> -<br> -Installing the manifest will create registry keys which allows tools to be able -to find the resource and message file(s) which contains event provider -information. Search MSDN for further details on the wevtutil tool.</p> - -<p class=MsoNormal style='margin-left:.25in;text-indent:-.25in'>3<span lang=EN -style='color:black'>.</span> <span lang=EN>Build the evntctrl executable -file (in evntdrv\evntctrl) by using the -cZg switch. Evntctrl sends IOCTLs to -Eventdrv, which then generates trace messages when it receives the IOCTLs.</span></p> - -<p class=MsoNormal style='margin-left:.25in;text-indent:-.25in'>4<span lang=EN -style='color:black'>.</span> Make a folder in the system directory called -ETWD<span lang=EN>riverSample. For example, C:\ETWDriverSample. Copy <u2:p>Eventdrv.sys -and evntctrl.exe to this folder. Also, copy Tracelog.exe from the tools\tracing -folder in the Driver Kit to this folder. This directory must be created because -the path to the resource file specified in the manifest evntdrv.xml points to -the %systemroot%\ETWDriverSample folder. If this folder is not created and the -Evntdrv.sys binary is not copied, decoding tools will not be able to find the -event information to decode the trace file. </u2:p></span></p> - -<p class=MsoNormal style='margin-left:.25in;text-indent:-.25in'>5<span lang=EN -style='color:black'>.</span> <span lang=EN>Use Tracelog to start a trace -session that is called �TestEventdrv�. The following command starts the trace -session and creates a trace log file, Eventdrv.etl, in the local directory.<br> -<br> -Tracelog -start TestEventdrv -guid #<span style='color:black'>b5a0bda9-50fe-4d0e-a83d-bae3f58c94d6 --f Eventdrv.etl</span></span></p> - -<p class=MsoNormal style='margin-left:.25in;text-indent:-.25in'>6<span lang=EN -style='color:black'>.</span> <span lang=EN>To generate trace messages, run -Evntctrl.exe. This executable file is built in step 3. Each time you type a -character other than Q or q, Evntctrl sends an IOCTL to the driver that signals -it to generate trace messages. To stop Evntctrl, type Q or q.</span></p> - -<u2:p></u2:p> - -<p class=MsoNormal style='margin-left:.25in;text-indent:-.25in'>7<span lang=EN -style='color:black'>.</span> <span lang=EN>To stop the trace session, use -the following Tracelog command:<br> -<br> -tracelog -stop TestEventdrv</span></p> - -<p class=MsoNormal style='margin-left:.25in;text-indent:-.25in'>8<span lang=EN -style='color:black'>.</span> <span lang=EN>To display the trace messages -in the Tracedrv.etl file, use Tracerpt. Type the following <br> -command:<br> -<br> -tracerpt Eventdrv.etl</span></p> - -<p class=MsoNormal style='margin-left:.25in;text-indent:-.25in'> -This creates two files: summary.txt and dumpfile.xml. Dumpfile.xml will contain -the event information in an XML format. For additional options, do tracerpt /?.</p> - -<p class=MsoNormal style='margin-left:.25in;text-indent:-.25in'>9. <span -lang=EN> To uninstall the manifest, use the following command:</span></p> - -<p class=MsoNormal style='margin-left:.25in;text-indent:-.25in'> -wevtutil um evntdrv.xml<span lang=EN><br> - </span></p> - -<u2:p></u2:p> - -<p class=MsoNormal><b><span lang=EN style='font-size:14.0pt'>Limitations</span></b></p> - -<u2:p></u2:p> - -<p class=MsoNormal><span lang=EN>Eventdrv is designed for Windows Vista and -later versions of Windows.<br> -This sample driver should not be used in a production environment.</span></p> - -<p class=MsoNormal> </p> - -<p class=MsoNormal><b><span lang=EN style='font-size:14.0pt'>File List</span></b></p> - -<u2:p></u2:p> - -<p class=MsoNormal><b><span lang=EN>Eventdrv<br> -</span></b><span lang=EN>Drvioctl.h<br> -Evntdrv.c<br> -Evntdrv.xml<br> -Makefile<br> -Makefile.inc<br> -Sources<u2:p></u2:p></span></p> - -<p class=MsoNormal><b><u><span lang=EN>Evntctrl</span></u></b><br> -<span lang=EN>Install.c<u><br> -</u>Install.h<u><br> -</u>Makefile<u><br> -</u>Sources<u><br> -</u>Tracectl.c</span></p> - -<p class=MsoNormal> </p> - -<p class=MsoNormal><b><span lang=EN style='font-size:14.0pt'>Location</span></b></p> - -<p class=MsoNormal><span lang=EN>The files that comprise Eventdrv are included -in the Windows Driver Kit in the \src\general\tracing\evntdrv folder.</span></p> - -<p class=MsoNormal> </p> - -</div> - -</div> - -</div> - -<u2:p></u2:p> -</body> - -</html> diff --git a/general/tracing/tracedriver/tracedrv.htm b/general/tracing/tracedriver/tracedrv.htm deleted file mode 100644 index 0d3dc032..00000000 --- a/general/tracing/tracedriver/tracedrv.htm +++ /dev/null @@ -1,1052 +0,0 @@ -<html xmlns:v="urn:schemas-microsoft-com:vml" -xmlns:o="urn:schemas-microsoft-com:office:office" -xmlns:w="urn:schemas-microsoft-com:office:word" -xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" -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 14"> -<meta name=Originator content="Microsoft Word 14"> -<link rel=File-List href="tracedrv_files/filelist.xml"> -<title>TraceDrv</title> -<link rel=themeData href="tracedrv_files/themedata.thmx"> -<link rel=colorSchemeMapping href="tracedrv_files/colorschememapping.xml"> -<!--[if gte mso 9]><xml> - <w:WordDocument> - <w:Zoom>114</w:Zoom> - <w:SpellingState>Clean</w:SpellingState> - <w:GrammarState>Clean</w:GrammarState> - <w:TrackMoves>false</w:TrackMoves> - <w:TrackFormatting/> - <w:ValidateAgainstSchemas/> - <w:SaveIfXMLInvalid>false</w:SaveIfXMLInvalid> - <w:IgnoreMixedContent>false</w:IgnoreMixedContent> - <w:AlwaysShowPlaceholderText>false</w:AlwaysShowPlaceholderText> - <w:DoNotPromoteQF/> - <w:LidThemeOther>EN-US</w:LidThemeOther> - <w:LidThemeAsian>X-NONE</w:LidThemeAsian> - <w:LidThemeComplexScript>X-NONE</w:LidThemeComplexScript> - <w:Compatibility> - <w:BreakWrappedTables/> - <w:SplitPgBreakAndParaMark/> - </w:Compatibility> - <w:BrowserLevel>MicrosoftInternetExplorer4</w:BrowserLevel> - <m:mathPr> - <m:mathFont m:val="Cambria Math"/> - <m:brkBin m:val="before"/> - <m:brkBinSub m:val="--"/> - <m:smallFrac m:val="off"/> - <m:dispDef/> - <m:lMargin m:val="0"/> - <m:rMargin m:val="0"/> - <m:defJc m:val="centerGroup"/> - <m:wrapIndent m:val="1440"/> - <m:intLim m:val="subSup"/> - <m:naryLim m:val="undOvr"/> - </m:mathPr></w:WordDocument> -</xml><![endif]--><!--[if gte mso 9]><xml> - <w:LatentStyles DefLockedState="false" DefUnhideWhenUsed="true" - DefSemiHidden="true" DefQFormat="false" DefPriority="99" - LatentStyleCount="267"> - <w:LsdException Locked="false" Priority="0" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Normal"/> - <w:LsdException Locked="false" Priority="9" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="heading 1"/> - <w:LsdException Locked="false" Priority="9" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="heading 2"/> - <w:LsdException Locked="false" Priority="9" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="heading 3"/> - <w:LsdException Locked="false" Priority="9" QFormat="true" Name="heading 4"/> - <w:LsdException Locked="false" Priority="9" QFormat="true" Name="heading 5"/> - <w:LsdException Locked="false" Priority="9" QFormat="true" Name="heading 6"/> - <w:LsdException Locked="false" Priority="9" QFormat="true" Name="heading 7"/> - <w:LsdException Locked="false" Priority="9" QFormat="true" Name="heading 8"/> - <w:LsdException Locked="false" Priority="9" QFormat="true" Name="heading 9"/> - <w:LsdException Locked="false" Priority="39" Name="toc 1"/> - <w:LsdException Locked="false" Priority="39" Name="toc 2"/> - <w:LsdException Locked="false" Priority="39" Name="toc 3"/> - <w:LsdException Locked="false" Priority="39" Name="toc 4"/> - <w:LsdException Locked="false" Priority="39" Name="toc 5"/> - <w:LsdException Locked="false" Priority="39" Name="toc 6"/> - <w:LsdException Locked="false" Priority="39" Name="toc 7"/> - <w:LsdException Locked="false" Priority="39" Name="toc 8"/> - <w:LsdException Locked="false" Priority="39" Name="toc 9"/> - <w:LsdException Locked="false" Priority="35" QFormat="true" Name="caption"/> - <w:LsdException Locked="false" Priority="10" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Title"/> - <w:LsdException Locked="false" Priority="1" Name="Default Paragraph Font"/> - <w:LsdException Locked="false" Priority="11" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Subtitle"/> - <w:LsdException Locked="false" Priority="22" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Strong"/> - <w:LsdException Locked="false" Priority="20" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Emphasis"/> - <w:LsdException Locked="false" Priority="59" SemiHidden="false" - UnhideWhenUsed="false" Name="Table Grid"/> - <w:LsdException Locked="false" UnhideWhenUsed="false" Name="Placeholder Text"/> - <w:LsdException Locked="false" Priority="1" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="No Spacing"/> - <w:LsdException Locked="false" Priority="60" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Shading"/> - <w:LsdException Locked="false" Priority="61" SemiHidden="false" - UnhideWhenUsed="false" Name="Light List"/> - <w:LsdException Locked="false" Priority="62" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Grid"/> - <w:LsdException Locked="false" Priority="63" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 1"/> - <w:LsdException Locked="false" Priority="64" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 2"/> - <w:LsdException Locked="false" Priority="65" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 1"/> - <w:LsdException Locked="false" Priority="66" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 2"/> - <w:LsdException Locked="false" Priority="67" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 1"/> - <w:LsdException Locked="false" Priority="68" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 2"/> - <w:LsdException Locked="false" Priority="69" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 3"/> - <w:LsdException Locked="false" Priority="70" SemiHidden="false" - UnhideWhenUsed="false" Name="Dark List"/> - <w:LsdException Locked="false" Priority="71" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Shading"/> - <w:LsdException Locked="false" Priority="72" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful List"/> - <w:LsdException Locked="false" Priority="73" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Grid"/> - <w:LsdException Locked="false" Priority="60" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Shading Accent 1"/> - <w:LsdException Locked="false" Priority="61" SemiHidden="false" - UnhideWhenUsed="false" Name="Light List Accent 1"/> - <w:LsdException Locked="false" Priority="62" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Grid Accent 1"/> - <w:LsdException Locked="false" Priority="63" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 1 Accent 1"/> - <w:LsdException Locked="false" Priority="64" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 2 Accent 1"/> - <w:LsdException Locked="false" Priority="65" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 1 Accent 1"/> - <w:LsdException Locked="false" UnhideWhenUsed="false" Name="Revision"/> - <w:LsdException Locked="false" Priority="34" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="List Paragraph"/> - <w:LsdException Locked="false" Priority="29" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Quote"/> - <w:LsdException Locked="false" Priority="30" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Intense Quote"/> - <w:LsdException Locked="false" Priority="66" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 2 Accent 1"/> - <w:LsdException Locked="false" Priority="67" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 1 Accent 1"/> - <w:LsdException Locked="false" Priority="68" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 2 Accent 1"/> - <w:LsdException Locked="false" Priority="69" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 3 Accent 1"/> - <w:LsdException Locked="false" Priority="70" SemiHidden="false" - UnhideWhenUsed="false" Name="Dark List Accent 1"/> - <w:LsdException Locked="false" Priority="71" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Shading Accent 1"/> - <w:LsdException Locked="false" Priority="72" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful List Accent 1"/> - <w:LsdException Locked="false" Priority="73" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Grid Accent 1"/> - <w:LsdException Locked="false" Priority="60" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Shading Accent 2"/> - <w:LsdException Locked="false" Priority="61" SemiHidden="false" - UnhideWhenUsed="false" Name="Light List Accent 2"/> - <w:LsdException Locked="false" Priority="62" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Grid Accent 2"/> - <w:LsdException Locked="false" Priority="63" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 1 Accent 2"/> - <w:LsdException Locked="false" Priority="64" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 2 Accent 2"/> - <w:LsdException Locked="false" Priority="65" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 1 Accent 2"/> - <w:LsdException Locked="false" Priority="66" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 2 Accent 2"/> - <w:LsdException Locked="false" Priority="67" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 1 Accent 2"/> - <w:LsdException Locked="false" Priority="68" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 2 Accent 2"/> - <w:LsdException Locked="false" Priority="69" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 3 Accent 2"/> - <w:LsdException Locked="false" Priority="70" SemiHidden="false" - UnhideWhenUsed="false" Name="Dark List Accent 2"/> - <w:LsdException Locked="false" Priority="71" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Shading Accent 2"/> - <w:LsdException Locked="false" Priority="72" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful List Accent 2"/> - <w:LsdException Locked="false" Priority="73" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Grid Accent 2"/> - <w:LsdException Locked="false" Priority="60" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Shading Accent 3"/> - <w:LsdException Locked="false" Priority="61" SemiHidden="false" - UnhideWhenUsed="false" Name="Light List Accent 3"/> - <w:LsdException Locked="false" Priority="62" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Grid Accent 3"/> - <w:LsdException Locked="false" Priority="63" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 1 Accent 3"/> - <w:LsdException Locked="false" Priority="64" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 2 Accent 3"/> - <w:LsdException Locked="false" Priority="65" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 1 Accent 3"/> - <w:LsdException Locked="false" Priority="66" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 2 Accent 3"/> - <w:LsdException Locked="false" Priority="67" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 1 Accent 3"/> - <w:LsdException Locked="false" Priority="68" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 2 Accent 3"/> - <w:LsdException Locked="false" Priority="69" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 3 Accent 3"/> - <w:LsdException Locked="false" Priority="70" SemiHidden="false" - UnhideWhenUsed="false" Name="Dark List Accent 3"/> - <w:LsdException Locked="false" Priority="71" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Shading Accent 3"/> - <w:LsdException Locked="false" Priority="72" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful List Accent 3"/> - <w:LsdException Locked="false" Priority="73" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Grid Accent 3"/> - <w:LsdException Locked="false" Priority="60" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Shading Accent 4"/> - <w:LsdException Locked="false" Priority="61" SemiHidden="false" - UnhideWhenUsed="false" Name="Light List Accent 4"/> - <w:LsdException Locked="false" Priority="62" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Grid Accent 4"/> - <w:LsdException Locked="false" Priority="63" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 1 Accent 4"/> - <w:LsdException Locked="false" Priority="64" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 2 Accent 4"/> - <w:LsdException Locked="false" Priority="65" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 1 Accent 4"/> - <w:LsdException Locked="false" Priority="66" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 2 Accent 4"/> - <w:LsdException Locked="false" Priority="67" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 1 Accent 4"/> - <w:LsdException Locked="false" Priority="68" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 2 Accent 4"/> - <w:LsdException Locked="false" Priority="69" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 3 Accent 4"/> - <w:LsdException Locked="false" Priority="70" SemiHidden="false" - UnhideWhenUsed="false" Name="Dark List Accent 4"/> - <w:LsdException Locked="false" Priority="71" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Shading Accent 4"/> - <w:LsdException Locked="false" Priority="72" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful List Accent 4"/> - <w:LsdException Locked="false" Priority="73" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Grid Accent 4"/> - <w:LsdException Locked="false" Priority="60" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Shading Accent 5"/> - <w:LsdException Locked="false" Priority="61" SemiHidden="false" - UnhideWhenUsed="false" Name="Light List Accent 5"/> - <w:LsdException Locked="false" Priority="62" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Grid Accent 5"/> - <w:LsdException Locked="false" Priority="63" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 1 Accent 5"/> - <w:LsdException Locked="false" Priority="64" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 2 Accent 5"/> - <w:LsdException Locked="false" Priority="65" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 1 Accent 5"/> - <w:LsdException Locked="false" Priority="66" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 2 Accent 5"/> - <w:LsdException Locked="false" Priority="67" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 1 Accent 5"/> - <w:LsdException Locked="false" Priority="68" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 2 Accent 5"/> - <w:LsdException Locked="false" Priority="69" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 3 Accent 5"/> - <w:LsdException Locked="false" Priority="70" SemiHidden="false" - UnhideWhenUsed="false" Name="Dark List Accent 5"/> - <w:LsdException Locked="false" Priority="71" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Shading Accent 5"/> - <w:LsdException Locked="false" Priority="72" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful List Accent 5"/> - <w:LsdException Locked="false" Priority="73" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Grid Accent 5"/> - <w:LsdException Locked="false" Priority="60" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Shading Accent 6"/> - <w:LsdException Locked="false" Priority="61" SemiHidden="false" - UnhideWhenUsed="false" Name="Light List Accent 6"/> - <w:LsdException Locked="false" Priority="62" SemiHidden="false" - UnhideWhenUsed="false" Name="Light Grid Accent 6"/> - <w:LsdException Locked="false" Priority="63" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 1 Accent 6"/> - <w:LsdException Locked="false" Priority="64" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Shading 2 Accent 6"/> - <w:LsdException Locked="false" Priority="65" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 1 Accent 6"/> - <w:LsdException Locked="false" Priority="66" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium List 2 Accent 6"/> - <w:LsdException Locked="false" Priority="67" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 1 Accent 6"/> - <w:LsdException Locked="false" Priority="68" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 2 Accent 6"/> - <w:LsdException Locked="false" Priority="69" SemiHidden="false" - UnhideWhenUsed="false" Name="Medium Grid 3 Accent 6"/> - <w:LsdException Locked="false" Priority="70" SemiHidden="false" - UnhideWhenUsed="false" Name="Dark List Accent 6"/> - <w:LsdException Locked="false" Priority="71" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Shading Accent 6"/> - <w:LsdException Locked="false" Priority="72" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful List Accent 6"/> - <w:LsdException Locked="false" Priority="73" SemiHidden="false" - UnhideWhenUsed="false" Name="Colorful Grid Accent 6"/> - <w:LsdException Locked="false" Priority="19" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Subtle Emphasis"/> - <w:LsdException Locked="false" Priority="21" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Intense Emphasis"/> - <w:LsdException Locked="false" Priority="31" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Subtle Reference"/> - <w:LsdException Locked="false" Priority="32" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Intense Reference"/> - <w:LsdException Locked="false" Priority="33" SemiHidden="false" - UnhideWhenUsed="false" QFormat="true" Name="Book Title"/> - <w:LsdException Locked="false" Priority="37" Name="Bibliography"/> - <w:LsdException Locked="false" Priority="39" QFormat="true" Name="TOC Heading"/> - </w:LatentStyles> -</xml><![endif]--> -<style> -<!-- - /* Font Definitions */ - @font-face - {font-family:SimSun; - panose-1:2 1 6 0 3 1 1 1 1 1; - mso-font-alt:\5B8B\4F53; - mso-font-charset:134; - mso-generic-font-family:auto; - mso-font-pitch:variable; - mso-font-signature:3 680460288 22 0 262145 0;} -@font-face - {font-family:"Cambria Math"; - panose-1:2 4 5 3 5 4 6 3 2 4; - mso-font-charset:0; - mso-generic-font-family:roman; - mso-font-pitch:variable; - mso-font-signature:-536870145 1107305727 0 0 415 0;} -@font-face - {font-family:Cambria; - panose-1:2 4 5 3 5 4 6 3 2 4; - mso-font-charset:0; - mso-generic-font-family:roman; - mso-font-pitch:variable; - mso-font-signature:-536870145 1073743103 0 0 415 0;} -@font-face - {font-family:Tahoma; - 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:-520081665 -1073717157 41 0 66047 0;} -@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:-1593833729 1073750107 16 0 415 0;} -@font-face - {font-family:"MS Sans Serif"; - mso-font-alt:"Times New Roman"; - mso-font-charset:0; - mso-generic-font-family:auto; - mso-font-pitch:auto; - mso-font-signature:0 0 0 0 0 0;} -@font-face - {font-family:"\@SimSun"; - panose-1:2 1 6 0 3 1 1 1 1 1; - mso-font-charset:134; - mso-generic-font-family:auto; - mso-font-pitch:variable; - mso-font-signature:3 680460288 22 0 262145 0;} - /* Style Definitions */ - p.MsoNormal, li.MsoNormal, div.MsoNormal - {mso-style-unhide:no; - mso-style-qformat:yes; - mso-style-parent:""; - margin:0in; - margin-bottom:.0001pt; - mso-pagination:widow-orphan; - font-size:12.0pt; - font-family:"Times New Roman","serif"; - mso-fareast-font-family:SimSun; - mso-fareast-theme-font:minor-fareast;} -h1 - {mso-style-priority:9; - mso-style-unhide:no; - mso-style-qformat:yes; - mso-style-link:"Heading 1 Char"; - margin-top:12.0pt; - margin-right:0in; - margin-bottom:3.0pt; - margin-left:0in; - mso-pagination:widow-orphan; - page-break-after:avoid; - mso-outline-level:1; - font-size:16.0pt; - font-family:"Arial","sans-serif"; - mso-fareast-font-family:SimSun; - mso-fareast-theme-font:minor-fareast; - font-weight:bold;} -h2 - {mso-style-priority:9; - mso-style-unhide:no; - mso-style-qformat:yes; - mso-style-link:"Heading 2 Char"; - 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","serif"; - mso-fareast-font-family:SimSun; - mso-fareast-theme-font:minor-fareast; - font-weight:bold;} -h3 - {mso-style-priority:9; - mso-style-unhide:no; - mso-style-qformat:yes; - mso-style-link:"Heading 3 Char"; - 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","serif"; - mso-fareast-font-family:SimSun; - mso-fareast-theme-font:minor-fareast; - font-weight:bold;} -p.MsoCommentText, li.MsoCommentText, div.MsoCommentText - {mso-style-noshow:yes; - mso-style-priority:99; - mso-style-link:"Comment Text Char"; - margin:0in; - margin-bottom:.0001pt; - mso-pagination:widow-orphan; - font-size:10.0pt; - font-family:"Times New Roman","serif"; - mso-fareast-font-family:SimSun; - mso-fareast-theme-font:minor-fareast;} -a:link, span.MsoHyperlink - {mso-style-noshow:yes; - mso-style-priority:99; - color:blue; - text-decoration:underline; - text-underline:single;} -a:visited, span.MsoHyperlinkFollowed - {mso-style-noshow:yes; - mso-style-priority:99; - color:blue; - text-decoration:underline; - text-underline:single;} -p - {mso-style-noshow:yes; - mso-style-priority:99; - 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","serif"; - mso-fareast-font-family:SimSun; - mso-fareast-theme-font:minor-fareast;} -p.MsoCommentSubject, li.MsoCommentSubject, div.MsoCommentSubject - {mso-style-noshow:yes; - mso-style-priority:99; - mso-style-link:"Comment Subject Char"; - margin:0in; - margin-bottom:.0001pt; - mso-pagination:widow-orphan; - font-size:10.0pt; - font-family:"Times New Roman","serif"; - mso-fareast-font-family:SimSun; - mso-fareast-theme-font:minor-fareast; - font-weight:bold;} -p.MsoAcetate, li.MsoAcetate, div.MsoAcetate - {mso-style-noshow:yes; - mso-style-priority:99; - mso-style-link:"Balloon Text Char"; - margin:0in; - margin-bottom:.0001pt; - mso-pagination:widow-orphan; - font-size:8.0pt; - font-family:"Tahoma","sans-serif"; - mso-fareast-font-family:SimSun; - mso-fareast-theme-font:minor-fareast;} -span.Heading1Char - {mso-style-name:"Heading 1 Char"; - mso-style-priority:9; - mso-style-unhide:no; - mso-style-locked:yes; - mso-style-link:"Heading 1"; - font-family:"Cambria","serif"; - mso-ascii-font-family:Cambria; - mso-hansi-font-family:Cambria; - color:#365F91; - font-weight:bold;} -span.Heading2Char - {mso-style-name:"Heading 2 Char"; - mso-style-noshow:yes; - mso-style-priority:9; - mso-style-unhide:no; - mso-style-locked:yes; - mso-style-link:"Heading 2"; - font-family:"Cambria","serif"; - mso-ascii-font-family:Cambria; - mso-hansi-font-family:Cambria; - color:#4F81BD; - font-weight:bold;} -span.Heading3Char - {mso-style-name:"Heading 3 Char"; - mso-style-noshow:yes; - mso-style-priority:9; - mso-style-unhide:no; - mso-style-locked:yes; - mso-style-link:"Heading 3"; - font-family:"Cambria","serif"; - mso-ascii-font-family:Cambria; - mso-hansi-font-family:Cambria; - color:#4F81BD; - font-weight:bold;} -span.CommentTextChar - {mso-style-name:"Comment Text Char"; - mso-style-noshow:yes; - mso-style-priority:99; - mso-style-unhide:no; - mso-style-locked:yes; - mso-style-link:"Comment Text";} -span.CommentSubjectChar - {mso-style-name:"Comment Subject Char"; - mso-style-noshow:yes; - mso-style-priority:99; - mso-style-unhide:no; - mso-style-locked:yes; - mso-style-link:"Comment Subject"; - font-weight:bold;} -span.BalloonTextChar - {mso-style-name:"Balloon Text Char"; - mso-style-noshow:yes; - mso-style-priority:99; - mso-style-unhide:no; - mso-style-locked:yes; - mso-style-link:"Balloon Text"; - font-family:"Tahoma","sans-serif"; - mso-ascii-font-family:Tahoma; - mso-hansi-font-family:Tahoma; - mso-bidi-font-family:Tahoma;} -p.msochpdefault, li.msochpdefault, div.msochpdefault - {mso-style-name:msochpdefault; - mso-style-unhide:no; - mso-margin-top-alt:auto; - margin-right:0in; - mso-margin-bottom-alt:auto; - margin-left:0in; - mso-pagination:widow-orphan; - font-size:10.0pt; - font-family:"Times New Roman","serif"; - mso-fareast-font-family:SimSun; - mso-fareast-theme-font:minor-fareast;} -span.SpellE - {mso-style-name:""; - mso-spl-e:yes;} -span.GramE - {mso-style-name:""; - mso-gram-e:yes;} -.MsoChpDefault - {mso-style-type:export-only; - mso-default-props:yes; - font-size:10.0pt; - mso-ansi-font-size:10.0pt; - mso-bidi-font-size:10.0pt;} -@page WordSection1 - {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.WordSection1 - {page:WordSection1;} - /* List Definitions */ - @list l0 - {mso-list-id:19862898; - mso-list-template-ids:-1324955294;} -@list l0:level1 - {mso-level-start-at:9; - mso-level-tab-stop:.5in; - mso-level-number-position:left; - text-indent:-.25in;} -@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;} -@list l1 - {mso-list-id:446238000; - mso-list-template-ids:845686190;} -@list l1:level1 - {mso-level-start-at:7; - mso-level-tab-stop:.5in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l1:level2 - {mso-level-tab-stop:1.0in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l1:level3 - {mso-level-tab-stop:1.5in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l1:level4 - {mso-level-tab-stop:2.0in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l1:level5 - {mso-level-tab-stop:2.5in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l1:level6 - {mso-level-tab-stop:3.0in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l1:level7 - {mso-level-tab-stop:3.5in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l1:level8 - {mso-level-tab-stop:4.0in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l1:level9 - {mso-level-tab-stop:4.5in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l2 - {mso-list-id:1103259907; - mso-list-template-ids:-601314756;} -@list l2:level1 - {mso-level-start-at:6; - mso-level-tab-stop:.5in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l2:level2 - {mso-level-tab-stop:1.0in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l2:level3 - {mso-level-tab-stop:1.5in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l2:level4 - {mso-level-tab-stop:2.0in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l2:level5 - {mso-level-tab-stop:2.5in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l2:level6 - {mso-level-tab-stop:3.0in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l2:level7 - {mso-level-tab-stop:3.5in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l2:level8 - {mso-level-tab-stop:4.0in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l2:level9 - {mso-level-tab-stop:4.5in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l3 - {mso-list-id:1166091645; - mso-list-template-ids:-1494308952;} -@list l3:level1 - {mso-level-start-at:5; - mso-level-tab-stop:.5in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l3:level2 - {mso-level-tab-stop:1.0in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l3:level3 - {mso-level-tab-stop:1.5in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l3:level4 - {mso-level-tab-stop:2.0in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l3:level5 - {mso-level-tab-stop:2.5in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l3:level6 - {mso-level-tab-stop:3.0in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l3:level7 - {mso-level-tab-stop:3.5in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l3:level8 - {mso-level-tab-stop:4.0in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l3:level9 - {mso-level-tab-stop:4.5in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l4 - {mso-list-id:1815415268; - mso-list-template-ids:467859314;} -@list l4:level1 - {mso-level-tab-stop:.5in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l4:level2 - {mso-level-tab-stop:1.0in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l4:level3 - {mso-level-tab-stop:1.5in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l4:level4 - {mso-level-tab-stop:2.0in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l4:level5 - {mso-level-tab-stop:2.5in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l4:level6 - {mso-level-tab-stop:3.0in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l4:level7 - {mso-level-tab-stop:3.5in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l4:level8 - {mso-level-tab-stop:4.0in; - mso-level-number-position:left; - text-indent:-.25in;} -@list l4: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-priority:99; - 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","serif";} -</style> -<![endif]--><!--[if gte mso 9]><xml> - <o:shapedefaults v:ext="edit" spidmax="1026"/> -</xml><![endif]--><!--[if gte mso 9]><xml> - <o:shapelayout v:ext="edit"> - <o:idmap v:ext="edit" data="1"/> - </o:shapelayout></xml><![endif]--> -</head> - -<body lang=EN-US link=blue vlink=blue style='tab-interval:.5in'> - -<div class=WordSection1> - -<h2><span class=SpellE><span style='font-family:"Verdana","sans-serif"; -mso-fareast-font-family:"Times New Roman"'>Tracedrv</span></span><span -style='font-family:"Verdana","sans-serif";mso-fareast-font-family:"Times New Roman"'> -</span><span style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></h2> - -<h3><span style='font-family:"Verdana","sans-serif";mso-fareast-font-family: -"Times New Roman"'>SUMMARY</span><span style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></h3> - -<p class=MsoNormal><span class=SpellE>Tracedrv</span> is a sample driver -instrumented for software tracing. The driver does not control any hardware; it -simply generates trace messages. It is designed to show how to use WPP software -tracing macros in a driver. </p> - -<p class=MsoNormal> </p> - -<p class=MsoNormal><span class=SpellE>Tracedrv</span> initializes tracing (by -using WPP_INIT_TRACING) and, when it receives a <span class=SpellE>DeviceIOControl</span> -call, it starts a thread that logs 100 trace messages. The WPP software tracing -directives, calls, and macros in the code are accompanied by comments that explain -their purpose.</p> - -<p class=MsoNormal> </p> - -<p class=MsoNormal>While examining <span class=SpellE>Tracedrv</span>, read the -"WPP Software Tracing" section of the Windows Driver Development Kit -(DDK) documentation (in Driver Development Tools, Tools for Software Tracing, -WPP Software Tracing). This section includes a reference section that describes -the directives, macros, and calls required for WPP software tracing. It also -includes "Sample WPP Software Tracing Code," a section that uses the <span -class=SpellE>Tracedrv</span> sample to demonstrate the use of the WPP software -tracing elements.</p> - -<p class=MsoNormal> </p> - -<h3><span style='font-family:"Verdana","sans-serif";mso-fareast-font-family: -"Times New Roman"'>USING THE SAMPLE</span><span style='mso-fareast-font-family: -"Times New Roman"'><o:p></o:p></span></h3> - -<p class=MsoNormal>To test the <span class=SpellE>Tracedrv</span> event tracing -provider, use the following procedure. The tools used in this procedure are -included in the DDK and located in the \tools\tracing subdirectory. For more -information about the tracing tools, see the "Tools for Software -Tracing" section of the WDK documentation.</p> - -<ol style='margin-top:0in' start=1 type=1> - <li class=MsoNormal style='margin-bottom:12.0pt;mso-list:l4 level1 lfo1; - tab-stops:list .5in'><span style='mso-fareast-font-family:"Times New Roman"'>Build - the <span class=SpellE>Tracedrv</span> sample driver and the <span - class=SpellE>Tracectl</span> executable file.<o:p></o:p></span></li> - <ol style='margin-top:0in' start=1 type=1> - <li class=MsoNormal style='margin-bottom:12.0pt;mso-list:l4 level2 lfo1; - tab-stops:list 1.0in'>Click tracedrv.sln to open the sample.<span - style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></li> - <li class=MsoNormal style='margin-bottom:12.0pt;mso-list:l4 level2 lfo1; - tab-stops:list 1.0in'>Right click project "<span class=SpellE>tracectl</span>", - select Properties, <span class=SpellE>goto</span> Linker -> Manifest - File, make sure "<span style='mso-fareast-font-family:SimSun'>Generate - Manifest</span>" is "No".<span style='mso-fareast-font-family: - "Times New Roman"'><o:p></o:p></span></li> - <li class=MsoNormal style='margin-bottom:12.0pt;mso-list:l4 level2 lfo1; - tab-stops:list 1.0in'>You can press "F7" or choose Build->Build - Solution.<span style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></li> - </ol> - <li class=MsoNormal style='margin-bottom:12.0pt;mso-list:l4 level1 lfo1; - tab-stops:list .5in'><span style='mso-fareast-font-family:"Times New Roman"'>Copy<i> - </i>the <i>Tracectl.exe </i>file that was created in step 1 from the <span - class=SpellE>Tracectl</span> directory (\<span class=SpellE>src</span>\general\tracing\<span - class=SpellE>tracedrv</span>\<span class=SpellE>tracectl</span>\<i>platform</i>) - to the <span class=SpellE>Tracedrv</span> directory (\<span class=SpellE>src</span>\general\tracing\<span - class=SpellE>tracedrv</span>\<span class=SpellE>tracedrv</span>\<i>platform</i>).<o:p></o:p></span></li> - <li class=MsoNormal style='mso-list:l4 level1 lfo1;tab-stops:list .5in'><span - style='mso-fareast-font-family:"Times New Roman"'>Use <span class=SpellE>Tracepdb</span> - to create a trace message format (TMF) file and a trace message control - (TMC) file from the <i>Tracedrv.pdb</i> file. <span class=SpellE>Tracepdb</span> - is located in the \bin\<i>platform</i> subdirectory of the WDK. The PDB - file that is used in this command is created by the Build utility in step - 1. From the \tools\tracing\<i>platform</i> subdirectory, type the - following command: <o:p></o:p></span></li> -</ol> - -<p class=MsoNormal style='margin-left:1.0in'><span class=SpellE><span -class=GramE><span style='font-size:10.0pt;font-family:"Courier New"'>tracepdb</span></span></span><span -style='font-size:10.0pt;font-family:"Courier New"'> -f <path>\tracedrv.pdb</span></p> - -<ol style='margin-top:0in' start=5 type=1> - <li class=MsoNormal style='mso-list:l3 level1 lfo2;tab-stops:list .5in'><span - style='mso-fareast-font-family:"Times New Roman"'>Create a control GUID - file for <span class=SpellE>Tracedrv</span> by opening a text file, adding - the following content, and saving the file as <span class=SpellE>Tracedrv.ctl</span>. - <o:p></o:p></span></li> -</ol> - -<p class=MsoNormal style='margin-left:1.0in'><span style='font-size:10.0pt; -font-family:"Courier New"'> -d58c126f-b309-11d1-969e-0000f875a5bc</span></p> - -<ol style='margin-top:0in' start=6 type=1> - <li class=MsoNormal style='mso-list:l2 level1 lfo3;tab-stops:list .5in'><span - style='mso-fareast-font-family:"Times New Roman"'>Use <span class=SpellE>Tracelog</span> - to start a trace session that is called "<span class=SpellE>TestTracedrv</span>". - <span class=SpellE>Tracelog</span> is located in the \tools\tracing\<i>platform</i> - subdirectory of the DDK. The <span class=SpellE><i>Tracedrv.ctl</i></span> - file that is used in this command was created in step 4. The following - command starts a trace session and creates a trace log file, <span - class=SpellE><i>tracedrv.etl</i></span>, in the local directory.<o:p></o:p></span></li> -</ol> - -<p class=MsoNormal style='margin-left:1.0in'><span style='font-size:10.0pt; -font-family:"Courier New"'> <span class=SpellE><span -class=GramE>tracelog</span></span> -start <span class=SpellE>TestTracedrv</span> --<span class=SpellE>guid</span> <span class=SpellE>tracedrv.ctl</span> -f <span -class=SpellE>tracedrv.etl</span> -flag 1</span></p> - -<p style='margin-left:.5in'><b>Note:</b> Without the <b>-flag</b> parameter, <span -class=SpellE>Tracedrv</span> will not generate any trace messages.</p> - -<ol style='margin-top:0in' start=7 type=1> - <li class=MsoNormal style='margin-bottom:12.0pt;mso-list:l1 level1 lfo4; - tab-stops:list .5in'><span style='mso-fareast-font-family:"Times New Roman"'>To - generate trace messages, run <i>Tracectl.exe</i>. This executable file is - built in step 2. Each time you type a character, other than <b>Q</b> or <b>q</b>, - <span class=SpellE>Tracectl</span> sends an IOCTL to the driver that - signals it to generate trace messages. To stop <span class=SpellE>Tracectl</span>, - type <b>Q</b> or <b>q</b>.<o:p></o:p></span></li> - <li class=MsoNormal style='mso-list:l1 level1 lfo4;tab-stops:list .5in'><span - style='mso-fareast-font-family:"Times New Roman"'>To stop the trace - session, use the following <span class=SpellE>Tracelog</span> command.<o:p></o:p></span></li> -</ol> - -<p class=MsoNormal style='margin-left:1.0in'><span style='font-size:10.0pt; -font-family:"Courier New"'> <span class=SpellE><span -class=GramE>tracelog</span></span> -stop <span class=SpellE>TestTracedrv</span></span></p> - -<ol style='margin-top:0in' start=9 type=1> - <li class=MsoNormal style='mso-list:l0 level1 lfo5;tab-stops:list .5in'><span - style='mso-fareast-font-family:"Times New Roman"'>To display the trace - messages in the <span class=SpellE><i>Tracedrv.etl</i></span> file, use <span - class=SpellE>Tracefmt</span>. <span class=SpellE>Tracefmt</span> is - located in the \tools\tracing subdirectory of the DDK. The TMF file used - in this command was created by <span class=SpellE>Tracepdb</span> in step - 3. Type the following command: <o:p></o:p></span></li> -</ol> - -<p class=MsoNormal style='margin-left:1.0in'><span style='font-size:10.0pt; -font-family:"Courier New"'> <span class=SpellE><span -class=GramE>tracefmt</span></span> <span class=SpellE>tracedrv.etl</span> -p -<Path to TMF file> -o <span class=SpellE>Tracedrv.out</span></span></p> - -<p>The resulting <span class=SpellE><i>Tracedrv.out</i></span> file is a -human-readable text file of the <span class=SpellE>Tracedrv</span> trace -messages. To interpret the trace messages, in the <span class=SpellE><i>Tracedrv.c</i></span> -file, search for the <span class=SpellE><b>DoTraceMessage</b></span> macros.</p> - -<p class=MsoNormal style='margin-left:.5in'> </p> - -<h3><span style='font-family:"Verdana","sans-serif";mso-fareast-font-family: -"Times New Roman"'>LIMITATIONS</span><span style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></h3> - -<p class=MsoNormal>This sample driver should not be used in a production -environment. </p> - -<p class=MsoNormal> </p> - -<p class=MsoNormal><span class=SpellE>Tracedrv</span> is designed for -Windows XP and later versions of Windows. It does not demonstrate how to -add WPP software tracing to a Windows 2000 driver. (For information about -adding WPP software tracing to a Windows 2000 driver, see the Tracing FAQ -topic in the Windows WDK documentation.)</p> - -<p class=MsoNormal> </p> - -<p class=MsoNormal>Also, because it is not a Plug and Play driver, <span -class=SpellE>Tracedrv</span> does not demonstrate tracing in a Plug and Play -environment. </p> - -<p class=MsoNormal> </p> - -<p class=MsoNormal><span class=SpellE>Tracedrv</span> demonstrates the basic -elements required for software tracing. It does not demonstrate more advanced -tracing techniques, such as writing customized tracing calls (variations of <span -class=SpellE><b>DoTraceMessage</b></span>), or the use of WMI calls for -software tracing. </p> - -<p class=MsoNormal> </p> - -<h3><span style='font-family:"Verdana","sans-serif";mso-fareast-font-family: -"Times New Roman"'>FILE LIST</span><span style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></h3> - -<p class=MsoNormal><span class=SpellE>drvioctl.h</span></p> - -<p class=MsoNormal><span class=SpellE><span class=GramE>makefile</span></span></p> - -<p class=MsoNormal><span class=GramE>sources</span></p> - -<p class=MsoNormal><span class=SpellE>tracedrv.c</span></p> - -<p class=MsoNormal><span class=SpellE>tracedrv.ctl</span></p> - -<p class=MsoNormal><span class=SpellE>tracedrv.rc</span></p> - -<p class=MsoNormal> </p> - -<h3><span style='font-family:"Verdana","sans-serif";mso-fareast-font-family: -"Times New Roman"'>LOCATION</span><span style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></h3> - -<p class=MsoNormal>The files that comprise <span class=SpellE>Tracedrv</span> -are included in the Windows DDK in the \<span class=SpellE>src</span>\general\tracing\<span -class=SpellE>tracedrv</span> directory.</p> - -<h3><span style='font-family:"Verdana","sans-serif";mso-fareast-font-family: -"Times New Roman"'> </span><span style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></h3> - -<h3><span style='font-family:"Verdana","sans-serif";mso-fareast-font-family: -"Times New Roman"'>FEEDBACK</span><span style='mso-fareast-font-family:"Times New Roman"'><o:p></o:p></span></h3> - -<p><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'>We welcome -your comments, problem reports, and wish-list requests. Please submit them by -visiting the <a href="http://go.microsoft.com/fwlink/?linkid=8704&clcid=0x409">Windows -DDK Web site</a>. </span></p> - -<p align=center style='text-align:center'><span style='font-size:10.0pt; -font-family:"Verdana","sans-serif"'><a -href="../../../../../INF/Readmes%20-%20Post%20WinHEC%202000/ChkInf.htm#top">Top -of page</a> </span></p> - -<table class=MsoNormalTable border=0 cellspacing=0 cellpadding=0 width=624 - style='width:6.5in;mso-cellspacing:0in;mso-yfti-tbllook:1184;mso-padding-alt: - 0in 0in 0in 0in'> - <tr style='mso-yfti-irow:0;mso-yfti-firstrow:yes;mso-yfti-lastrow:yes; - height:1.5pt'> - <td style='background:aqua;padding:.75pt .75pt .75pt .75pt;height:1.5pt'> - <p class=MsoNormal><span style='font-size:2.0pt'> </span></p> - </td> - </tr> -</table> - -<p><span style='font-size:7.5pt;font-family:"MS Sans Serif"'>� Microsoft -Corporation 2005</span><span style='font-size:10.0pt;font-family:"Verdana","sans-serif"'> -</span></p> - -</div> - -</body> - -</html> |