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/tracing | |
| parent | bd17fd844b4f074821b9d4c7bc86b9dc7f0e4a59 (diff) | |
Remove obsolete readme.htm files
Diffstat (limited to 'general/tracing')
| -rw-r--r-- | general/tracing/evntdrv/evntdrv.htm | 189 | ||||
| -rw-r--r-- | general/tracing/tracedriver/tracedrv.htm | 1052 |
2 files changed, 0 insertions, 1241 deletions
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> |