TraceWPP task

De Windows Driver Kit (WDK) biedt de TraceWPP-taak, zodat u het hulpprogramma tracewpp.exe kunt uitvoeren wanneer u uw stuurprogramma bouwt met BEHULP van MSBuild. Het hulpprogramma tracewpp.exe wordt gebruikt om WPP-softwaretracering te implementeren.

WppEnabled is een nieuwe metagegevens voor het ClCompile-item dat tracering voor bronbestanden mogelijk maakt. The Wpp task runs through the entire ClCompile Item Collections and invokes tracewpp.exe for each Item for which the WppEnabled metadata is set to TRUE.

De metagegevens van WppEnabled zijn toegevoegd aan het ClCompile-item omdat de WPP-taak wordt uitgevoerd op hetzelfde type invoerbestanden als de CL-taak, in dit geval .c, .cpp en .h-bestanden.

Note You access the Item metadata for tracewpp by using the ClCompile item in project files. MSBuild maakt intern gebruik van het TraceWpp-item binnen het doel om het door te geven aan de taak.

In het volgende voorbeeld ziet u hoe u de metagegevens in het .vcxproj-bestand bewerkt.

<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>

De aanroep van de opdrachtregel is:

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

The example above shows that MSBuild invokes tracewpp.exe only on b.c and test2.c because the WppEnabled metadata is set to TRUE for these inputs. Houd er ook rekening mee dat de metagegevens voor deze twee invoer verschillend zijn. Daarom zijn de schakelaars ook anders voor deze invoer. Met andere woorden, u kunt elke invoer aanroepen met een eigen set metagegevens.

WPP-taakparameter	Item Metadata	Tool Switch
Sources Vereiste ITaskItem[] parameter. Hiermee geeft u een lijst met bronbestanden.	@(TraceWpp)
AddAlternateNameToMessageGUID Optionele tekenreeksparameter. Hiermee geeft u een alternatieve beschrijvende naam op voor de bericht-GUID voor berichten die afkomstig zijn van deze traceringsprovider.	%(TraceWpp.WppAddAlternateNameToMessageGUID)	-o:String
AdditionalConfigurationFile Optionele tekenreeksparameter. Hiermee geeft u een extra configuratiebestand. WPP maakt gebruik van het opgegeven bestand naast het standaardbestand, defaultwpp.ini.	%(TraceWpp.WppAdditionalConfigurationFile)	-ini:Path
AdditionalIncludeDirectories Optionele tekenreeks[] parameter. Voegt een map toe aan de lijst met mappen waarnaar WPP zoekt naar insluitingsbestanden.	%(TraceWpp.WppAdditionalIncludeDirectories)	-I
AlternateConfigurationFile Optionele tekenreeksparameter. Hiermee geeft u een alternatief configuratiebestand. WPP gebruikt dit bestand in plaats van het defaultwpp.ini-bestand.	%(TraceWpp.WppAlternateConfigurationFile)	-defwpp:Path
GenerateUsingTemplateFile Optionele tekenreeksparameter. Voor elk bronbestand dat WPP verwerkt met de naam die tussen de accolades {}is opgegeven, maakt WPP een ander bestand met de opgegeven bestandsnaamextensie.	%(TraceWpp.WppGenerateUsingTemplateFile)	-gen{File.tpl}*.ext
MinimalRebuildFromTracking Optionele Booleaanse parameter. If the value is TRUE, WPP performs a tracked incremental build. Anders voert WPP een herbouw uit.	%(TraceWpp.WppMinimalRebuildFromTracking)
NumericBaseForFormatStrings Optionele int-parameter. Hiermee wordt een numerieke basis voor de nummering van notatietekenreeksen gemaakt.	%(TraceWpp.WppNumericBaseForFormatStrings)	-argbase:Number
AddControlGUID Optionele tekenreeksparameter. Definieert een WPP_CONTROL_GUIDS macro met de opgegeven besturings-GUID en WPP_DEFINE_BIT vermeldingen met de naam Fout, Ongebruikelijk en Ruis.	%(TraceWpp.WppAddControlGUID)	-ctl:GUID
AdditionalOptions Optionele tekenreeksparameter. Een lijst met opdrachtregelopties.	%(TraceWpp.WppAdditionalOptions)
ConfigurationDirectories Optionele tekenreeks[] parameter. Hiermee geeft u de locatie van configuratie- en sjabloonbestanden.	%(TraceWpp.WppConfigurationDirectories)	-cfgdir:[Path]
DllMacro Optionele Booleaanse parameter. Hiermee definieert u de WPP_DLL macro.	%(TraceWpp.WppDllMacro)	-dll
FileExtensions Optionele tekenreeks[] parameter. Hiermee geeft u de bestandstypen op die WPP herkent als bronbestanden. WPP negeert bestanden met een andere bestandsnaamextensie.	%(TraceWpp.WppFileExtensions)	-ext:.ext1 [.ext2]
IgnoreExclamationmarks Optionele Booleaanse parameter. Hiermee wordt WPP om uitroeptekens te negeren, ook wel 'shrieks' genoemd, gebruikt in complexe opmaak, zoals %!timestamp!%.	%(TraceWpp.WppIgnoreExclamationmarks)	-noshrieks
KernelMode Optionele Booleaanse parameter. Hiermee definieert u de WPP_KERNEL_MODE macro, die onderdelen van de kernelmodus traceert. Standaard worden alleen onderdelen van de gebruikersmodus getraceerd.	%(TraceWpp.WppKernelMode)	-km
OutputDirectory Optionele tekenreeksparameter. Hiermee geeft u de map voor de uitvoerbestanden die WPP maakt.	%(TraceWpp.WppOutputDirectory)	-odir:Path
PreprocessorDefinitions Optionele tekenreeks[] parameter. Hiermee definieert u een voorverwerkingssymbool voor uw bronbestand.	%(TraceWpp.WppPreprocessorDefinitions)	/D
PreserveExtensions Optionele tekenreeks[] parameter. Behoudt de opgegeven bestandsnaamextensies bij het maken van TMH-bestanden.	%(TraceWpp.WppPreserveExtensions)	-preserveext:ext1[,ext2]
ScanConfigurationData Optionele tekenreeksparameter. Zoekt naar configuratiegegevens, zoals aangepaste gegevenstypen, in een bestand dat geen configuratiebestand is, evenals in defaultwpp.ini.	%(TraceWpp.WppScanConfigurationData)	-scan:File
SearchString Optionele tekenreeksparameter. Hiermee wordt WPP om de bronbestanden voor de opgegeven tekenreeks te doorzoeken om tracering te initiëren.	%(TraceWpp.WppSearchString)	-lookfor:String
ToolPath Optionele tekenreeksparameter. Hiermee kunt u het volledige pad opgeven naar de map waar het hulpprogramma zich bevindt.	$(WPPToolPath)
TraceFunction Optionele tekenreeks[] parameter. Hiermee geeft u functies op die vervolgens kunnen worden gebruikt om traceringsberichten te genereren.	%(TraceWpp.WppTraceFunction)	-func:FunctionDescription
TrackerLogDirectory Optionele tekenreeksparameter. Logboekmap voor tracker voor het schrijven van tlogs.	%(TraceWpp.WppTrackerLogDirectory)
TrackFileAccess Optionele Booleaanse parameter. Indien waar, houdt u patronen voor bestandstoegang voor deze taak bij.	$(TrackFileAccess)

verwante onderwerpen

WPP Preprocessor

WPP Software Tracering