TraceWPP task

Sada Windows Driver Kit (WDK) poskytuje úlohu TraceWPP, abyste mohli spustit nástroj tracewpp.exe při sestavování ovladače pomocí nástroje MSBuild. Nástroj tracewpp.exe slouží k implementaci trasování softwaru WPP.

WppEnabled je nová metadata pro položku ClCompile, která umožňuje trasování zdrojových souborů. 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.

Metadata WppEnabled byla přidána do ClCompile Item, protože úloha WPP běží na stejném typu vstupních souborů jako úloha CL, v tomto případě .c, .cpp a .h soubory.

Note You access the Item metadata for tracewpp by using the ClCompile item in project files. Nástroj MSBuild interně používá položku TraceWpp uvnitř cíle k předání úkolu.

Následující příklad ukazuje, jak upravit metadata v souboru .vcxproj.

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

Vyvolání příkazového řádku by bylo:

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. Všimněte si také, že metadata pro tyto dva vstupy jsou odlišná. Proto se přepínače budou pro tyto vstupy lišit. Jinými slovy, můžete volat každý vstup s vlastní sadou metadat.

Parametr úlohy WPP	Item Metadata	Tool Switch
Sources Povinný parametr ITaskItem[]. Určuje seznam zdrojových souborů.	@(TraceWpp)
AddAlternateNameToMessageGUID Volitelný parametr řetězce. Určuje alternativní popisný název pro identifikátor GUID zprávy pro zprávy, které pocházejí z tohoto zprostředkovatele trasování.	%(TraceWpp.WppAddAlternateNameToMessageGUID)	-o:String
AdditionalConfigurationFile Volitelný parametr řetězce. Určuje další konfigurační soubor. WPP používá kromě výchozího souboru kromě výchozího souboru defaultwpp.ini.	%(TraceWpp.WppAdditionalConfigurationFile)	-ini:Path
AdditionalIncludeDirectories Volitelný parametr string[] Přidá adresář do seznamu adresářů, které WPP hledá v zahrnutí souborů.	%(TraceWpp.WppAdditionalIncludeDirectories)	-I
AlternateConfigurationFile Volitelný parametr řetězce. Určuje alternativní konfigurační soubor. WPP používá tento soubor místo defaultwpp.ini souboru.	%(TraceWpp.WppAlternateConfigurationFile)	-defwpp:Path
GenerateUsingTemplateFile Volitelný parametr řetězce. Pro každý zdrojový soubor, který WPP zpracovává s názvem zadaným mezi složenými závorkami {}, WPP vytvoří jiný soubor se zadanou příponou názvu souboru.	%(TraceWpp.WppGenerateUsingTemplateFile)	-gen{File.tpl}*.ext
MinimalRebuildFromTracking Volitelný logický parametr. If the value is TRUE, WPP performs a tracked incremental build. V opačném případě WPP provede opětovné sestavení.	%(TraceWpp.WppMinimalRebuildFromTracking)
NumericBaseForFormatStrings Volitelný parametr int. Vytvoří číselnou základnu pro číslování řetězců formátu.	%(TraceWpp.WppNumericBaseForFormatStrings)	-argbase:Number
AddControlGUID Volitelný parametr řetězce. Definuje WPP_CONTROL_GUIDS makro se zadaným identifikátorem GUID ovládacího prvku a WPP_DEFINE_BIT položkami s názvem Chyba, Neobvyklé a Šum.	%(TraceWpp.WppAddControlGUID)	-ctl:GUID
AdditionalOptions Volitelný parametr řetězce. Seznam možností příkazového řádku	%(TraceWpp.WppAdditionalOptions)
ConfigurationDirectories Volitelný parametr string[] Určuje umístění konfiguračních souborů a souborů šablon.	%(TraceWpp.WppConfigurationDirectories)	-cfgdir:[Path]
DllMacro Volitelný logický parametr. Definuje WPP_DLL makro.	%(TraceWpp.WppDllMacro)	-dll
FileExtensions Volitelný parametr string[] Určuje typy souborů, které WPP rozpozná jako zdrojové soubory. WPP ignoruje soubory s jinou příponou názvu souboru.	%(TraceWpp.WppFileExtensions)	-ext:.ext1 [.ext2]
IgnoreExclamationmarks Volitelný logický parametr. Přesměruje WPP na ignorování vykřičníků, označovaných také jako "shrieks", které se používají ve složitém formátování, jako je například %!timestamp!%.	%(TraceWpp.WppIgnoreExclamationmarks)	-noshrieks
KernelMode Volitelný logický parametr. Definuje WPP_KERNEL_MODE makro, které sleduje komponenty režimu jádra. Ve výchozím nastavení jsou trasovány pouze komponenty uživatelského režimu.	%(TraceWpp.WppKernelMode)	-km
OutputDirectory Volitelný parametr řetězce. Určuje adresář pro výstupní soubory, které WPP vytvoří.	%(TraceWpp.WppOutputDirectory)	-odir:Path
PreprocessorDefinitions Volitelný parametr string[] Definuje symbol předběžného zpracování pro zdrojový soubor.	%(TraceWpp.WppPreprocessorDefinitions)	/D
PreserveExtensions Volitelný parametr string[] Zachová zadanou příponu názvu souboru při vytváření souborů TMH.	%(TraceWpp.WppPreserveExtensions)	-preserveext:ext1[,ext2]
ScanConfigurationData Volitelný parametr řetězce. Vyhledá konfigurační data, například vlastní datové typy, v souboru, který není konfiguračním souborem, a také v defaultwpp.ini.	%(TraceWpp.WppScanConfigurationData)	-scan:File
SearchString Volitelný parametr řetězce. Nasměruje WPP, aby hledal zdrojový soubor zadaného řetězce, aby zahájil trasování.	%(TraceWpp.WppSearchString)	-lookfor:String
ToolPath Volitelný parametr řetězce. Umožňuje zadat úplnou cestu ke složce, ve které se nástroj nachází.	$(WPPToolPath)
TraceFunction Volitelný parametr string[] Určuje funkce, které lze použít ke generování trasovacích zpráv.	%(TraceWpp.WppTraceFunction)	-func:FunctionDescription
TrackerLogDirectory Volitelný parametr řetězce. Adresář protokolu pro sledování pro zápis tlogů.	%(TraceWpp.WppTrackerLogDirectory)
TrackFileAccess Volitelný logický parametr. Pokud je pravda, sleduje vzory přístupu k souborům pro tuto úlohu.	$(TrackFileAccess)

související témata

WPP Preprocessor

WPP trasování softwaru