TraceWPP-Aufgabe

Das Windows Driver Kit (WDK) stellt die TraceWPP-Aufgabe bereit, sodass Sie das tracewpp.exe-Tool ausführen können, wenn Sie Ihren Treiber mithilfe von MSBuild erstellen. Das tracewpp.exe-Tool wird verwendet, um die WPP-Softwareablaufverfolgung zu implementieren.

WppEnabled ist eine neue Metadaten für das ClCompile-Element, das die Ablaufverfolgung für Quelldateien aktiviert. Der Wpp-Task durchläuft die gesamten ClCompile-Elementsammlungen und ruft tracewpp.exe für jedes Element auf, für das die WppEnabled-Metadaten auf TRUE festgelegt sind.

Die WppEnabled-Metadaten wurden dem ClCompile-Element hinzugefügt, da der WPP-Task mit demselben Typ von Eingabedateien wie der CL-Task ausgeführt wird, in diesem Fall C-, .cpp- und H-Dateien.

Hinweis Sie greifen auf die Elementmetadaten für tracewpp zu, indem Sie das ClCompile-Element in Projektdateien verwenden. MSBuild verwendet das TraceWpp-Element intern im Ziel, um es an die Aufgabe zu übergeben.

Im folgenden Beispiel wird gezeigt, wie Sie die Metadaten in der .vcxproj-Datei bearbeiten.

<ItemGroup>
    <ClCompile Include="a.c" />
      <WppEnabled>false</WppEnabled>
    <ClCompile Include="b.c">
        <WppEnabled>true</WppEnabled>
        <WppKernelMode>true</WppKernelMode>
        <WppAdditionalIncludeDirectories>c:\test\</WppAdditionalIncludeDirectories>
    </ClCompile>
    <ClCompile Include="test1.c" />
    <ClCompile Include="test2.c">
        <WppEnabled>true</WppEnabled>
        <WppDllMacro>true</WppDllMacro>
    </ClCompile>
</ItemGroup>

Der Befehlszeilenaufruf wäre:

tracewpp.exe  km /Ic:\test\b.c
tracewpp.exe  dll test2.c

Das obige Beispiel zeigt, dass MSBuild tracewpp.exe nur für b.c und test2.c aufruft, da die WppEnabled-Metadaten für diese Eingaben auf TRUE festgelegt sind. Beachten Sie auch, dass die Metadaten für diese beiden Eingaben unterschiedlich sind. Daher unterscheiden sich die Schalter auch für diese Eingänge. Mit anderen Worten, Sie können jede Eingabe mit einem eigenen Satz von Metadaten aufrufen.

WPP-Vorgangsparameter	Elementmetadaten	Toolwechsel
Sources Erforderliche ITaskItem [] Parameter. Gibt eine Liste der Quelldateien an.	@(TraceWpp)
AddAlternateNameToMessageGUID Optionaler Zeichenfolgenparameter. Gibt einen alternativen Anzeigenamen für die Nachrichten-GUID für Nachrichten an, die von diesem Ablaufverfolgungsanbieter stammen.	%(TraceWpp.WppAddAlternateNameToMessageGUID)	-o:String
AdditionalConfigurationFile Optionaler Zeichenfolgenparameter. Gibt eine zusätzliche Konfigurationsdatei an. WPP verwendet die angegebene Datei zusätzlich zur Standarddatei, defaultwpp.ini.	%(TraceWpp.WppAdditionalConfigurationFile)	-ini:Pfad
AdditionalIncludeDirectories Optionaler String[]-Parameter. Fügt der Liste der Verzeichnisse, die WPP nach Includedateien sucht, ein Verzeichnis hinzu.	%(TraceWpp.WppAdditionalIncludeDirectories)	-I
AlternateConfigurationFile Optionaler Zeichenfolgenparameter. Gibt eine alternative Konfigurationsdatei an. WPP verwendet diese Datei anstelle der defaultwpp.ini-Datei.	%(TraceWpp.WppAlternateConfigurationFile)	-defwpp:Pfad
GenerateUsingTemplateFile Optionaler Zeichenfolgenparameter. Für jede Quelldatei, die WPP mit dem zwischen den Klammern {}angegebenen Namen verarbeitet, erstellt WPP eine weitere Datei mit der angegebenen Dateinamenerweiterung.	%(TraceWpp.WppGenerateUsingTemplateFile)	-gen{File.tpl}*.ext
MinimalRebuildFromTracking Optionaler boolescher Parameter. Wenn der Wert TRUE ist, führt WPP einen nachverfolgten inkrementellen Build aus. Andernfalls führt WPP eine Neuerstellung durch.	%(TraceWpp.WppMinimalRebuildFromTracking)
NumericBaseForFormatStrings Optionaler int-Parameter. Erstellt eine numerische Basis für die Nummerierung von Formatzeichenfolgen.	%(TraceWpp.WppNumericBaseForFormatStrings)	-argbase:Zahl
AddControlGUID Optionaler Zeichenfolgenparameter. Definiert ein WPP_CONTROL_GUIDS Makro mit der angegebenen Steuerelement-GUID und WPP_DEFINE_BIT Einträgen namens "Error", "Unusual" und "Noise".	%(TraceWpp.WppAddControlGUID)	-ctl:GUID
AdditionalOptions Optionaler Zeichenfolgenparameter. Eine Liste von Befehlszeilenoptionen.	%(TraceWpp.WppAdditionalOptions)
Konfigurationsverzeichnisse Optionaler String[]-Parameter. Gibt den Speicherort der Konfigurations- und Vorlagendateien an.	%(TraceWpp.WppConfigurationDirectories)	-cfgdir:[Pfad]
DllMacro Optionaler boolescher Parameter. Definiert das makro WPP_DLL.	%(TraceWpp.WppDllMacro)	-Dll
FileExtensions Optionaler String[]-Parameter. Gibt die Dateitypen an, die WPP als Quelldateien erkennt. WPP ignoriert Dateien mit einer anderen Dateinamenerweiterung.	%(TraceWpp.WppFileExtensions)	-ext:.ext1 [.ext2]
IgnoreExclamationmarks Optionaler boolescher Parameter. Weist WPP an, Ausrufezeichen, die auch als "Shrieks" bezeichnet werden, zu ignorieren, die in komplexen Formatierungen verwendet werden, z. B. %!timestamp!%.	%(TraceWpp.WppIgnoreExclamationmarks)	-noshrieks
KernelMode Optionaler boolescher Parameter. Definiert das WPP_KERNEL_MODE Makros, das Kernelmoduskomponenten verfolgt. Standardmäßig werden nur Komponenten im Benutzermodus nachverfolgt.	%(TraceWpp.WppKernelMode)	-Km
OutputDirectory Optionaler Zeichenfolgenparameter. Gibt das Verzeichnis für die Ausgabedateien an, die WPP erstellt.	%(TraceWpp.WppOutputDirectory)	-odir:Path
PreprocessorDefinitions Optionaler String[]-Parameter. Definiert ein Präprozessorsymbol für Ihre Quelldatei.	%(TraceWpp.WppPreprocessorDefinitions)	/D
PreserveExtensions Optionaler String[]-Parameter. Behält die angegebenen Dateinamenerweiterungen beim Erstellen von TMH-Dateien bei.	%(TraceWpp.WppPreserveExtensions)	-preserveext:ext1[,ext2]
ScanConfigurationData Optionaler Zeichenfolgenparameter. Sucht nach Konfigurationsdaten, z. B. benutzerdefinierten Datentypen, in einer Datei, die keine Konfigurationsdatei ist, sowie in defaultwpp.ini.	%(TraceWpp.WppScanConfigurationData)	-scan:File
Searchstring Optionaler Zeichenfolgenparameter. Weist WPP an, die Quelldateien nach der angegebenen Zeichenfolge zu durchsuchen, um die Ablaufverfolgung zu initiieren.	%(TraceWpp.WppSearchString)	-lookfor:String
Schneidweg Optionaler Zeichenfolgenparameter. Hiermit können Sie den vollständigen Pfad zu dem Ordner angeben, in dem sich das Tool befindet.	$(WPPToolPath)
TraceFunction Optionaler String[]-Parameter. Gibt Funktionen an, die dann zum Generieren von Ablaufverfolgungsmeldungen verwendet werden können.	%(TraceWpp.WppTraceFunction)	-func:FunctionDescription
TrackerLogDirectory Optionaler Zeichenfolgenparameter. Protokollverzeichnis für die Nachverfolgung zum Schreiben von Tlogs.	%(TraceWpp.WppTrackerLogDirectory)
TrackFileAccess Optionaler boolescher Parameter. Wenn true, werden Dateizugriffsmuster für diese Aufgabe nachverfolgt.	$(TrackFileAccess)

Verwandte Themen

WPP-Präprozessor

WPP-Softwareverfolgung