Attività TraceWPP
Windows Driver Kit (WDK) fornisce l'attività TraceWPP in modo da poter eseguire lo strumento tracewpp.exe quando si compila il driver usando MSBuild. Lo strumento tracewpp.exe viene usato per implementare WPP Software Tracing.
WppEnabled è un nuovo metadati per l'elemento ClCompile che consente la traccia per i file di origine. L'attività Wpp viene eseguita nell'intera raccolta di elementi ClCompile e richiama tracewpp.exe per ogni elemento per cui i metadati WppEnabled sono impostati su TRUE.
I metadati WppEnabled sono stati aggiunti all'elemento ClCompile perché l'attività WPP viene eseguita nello stesso tipo di file di input dell'attività CL, in questo caso .c, .cpp e file con estensione h.
Nota È possibile accedere ai metadati dell'elemento per tracewpp usando l'elemento ClCompile nei file di progetto. MSBuild usa l'elemento TraceWpp internamente all'interno della destinazione per passarlo all'attività.
Nell'esempio seguente viene illustrato come modificare i metadati nel file .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>
La chiamata della riga di comando sarà:
tracewpp.exe km /Ic:\test\b.c
tracewpp.exe dll test2.c
L'esempio precedente mostra che MSBuild richiama tracewpp.exe solo in b.c e test2.c perché i metadati WppEnabled sono impostati su TRUE per questi input. Si noti anche che i metadati per questi due input sono diversi. Pertanto, le opzioni saranno diverse anche per questi input. In altre parole, è possibile chiamare ogni input con il proprio set di metadati.
| Parametro attività WPP | Metadati degli elementi | Opzione strumento |
|---|---|---|
|
recenti
Parametro ITaskItem [] obbligatorio. Specifica un elenco di file di origine. |
@(TraceWpp) | |
|
AddAlternateNameToMessageGUID
Parametro stringa facoltativo. Specifica un nome descrittivo alternativo per il GUID del messaggio per i messaggi provenienti da questo provider di traccia. |
%(TraceWpp.WppAddAlternateNameToMessageGUID) | -o:String |
|
AdditionalConfigurationFile
Parametro stringa facoltativo. Specifica un file di configurazione aggiuntivo. WPP usa il file specificato oltre al file predefinito defaultwpp.ini. |
%(TraceWpp.WppAdditionalConfigurationFile) | -ini:Path |
|
AdditionalIncludeDirectories
Parametro string[] facoltativo. Aggiunge una directory all'elenco di directory in cui WPP cerca i file di inclusione. |
%(TraceWpp.WppAdditionalIncludeDirectories) | -I |
|
AlternateConfigurationFile
Parametro stringa facoltativo. Specifica un file di configurazione alternativo. WPP usa questo file anziché il file defaultwpp.ini. |
%(TraceWpp.WppAlternateConfigurationFile) | -defwpp:Path |
|
GenerateUsingTemplateFile
Parametro stringa facoltativo. Per ogni file di origine elaborato da WPP con il nome specificato tra parentesi graffe {}, WPP crea un altro file con l'estensione del nome file specificata. |
%(TraceWpp.WppGenerateUsingTemplateFile) | -gen{File.tpl}*.ext |
|
MinimalRebuildFromTracking
Parametro booleano facoltativo. Se il valore è TRUE, WPP esegue una compilazione incrementale rilevata. In caso contrario, WPP esegue una ricompilazione. |
%(TraceWpp.WppMinimalRebuildFromTracking) | |
|
NumericBaseForFormatStrings
Parametro int facoltativo. Stabilisce una base numerica per la numerazione delle stringhe di formato. |
%(TraceWpp.WppNumericBaseForFormatStrings) | -argbase:Number |
|
AddControlGUID
Parametro stringa facoltativo. Definisce una macro WPP_CONTROL_GUIDS con il GUID del controllo specificato e WPP_DEFINE_BIT voci denominate 'Error', 'Unusual' e 'Noise'. |
%(TraceWpp.WppAddControlGUID) | -ctl:GUID |
|
Opzioni aggiuntive
Parametro stringa facoltativo. Elenco di opzioni della riga di comando. |
%(TraceWpp.WppAdditionalOptions) | |
|
ConfigurationDirectories
Parametro string[] facoltativo. Specifica il percorso dei file di configurazione e modello. |
%(TraceWpp.WppConfigurationDirectories) | -cfgdir:[Path] |
|
DllMacro
Parametro booleano facoltativo. Definisce la macro WPP_DLL. |
%(TraceWpp.WppDllMacro) | -dll |
|
FileExtensions
Parametro string[] facoltativo. Specifica i tipi di file riconosciuti da WPP come file di origine. WPP ignora i file con un'estensione di file diversa. |
%(TraceWpp.WppFileExtensions) | -ext:.ext1 [.ext2] |
|
IgnoreExclamationmarks
Parametro booleano facoltativo. Indica a WPP di ignorare i segni esclamativi, noti anche come "shrieks", usati nella formattazione complessa, ad esempio %!timestamp!%. |
%(TraceWpp.WppIgnoreExclamationmarks) | -noshrieks |
|
KernelMode
Parametro booleano facoltativo. Definisce la macro WPP_KERNEL_MODE, che traccia i componenti in modalità kernel. Per impostazione predefinita, vengono tracciati solo i componenti in modalità utente. |
%(TraceWpp.WppKernelMode) | -km |
|
OutputDirectory
Parametro stringa facoltativo. Specifica la directory per i file di output creati da WPP. |
%(TraceWpp.WppOutputDirectory) | -odir:Path |
|
PreprocessorDefinitions
Parametro string[] facoltativo. Definisce un simbolo di pre-elaborazione per il file di origine. |
%(TraceWpp.WppPreprocessorDefinitions) | /D |
|
PreserveExtensions
Parametro string[] facoltativo. Mantiene le estensioni del nome file specificate durante la creazione di file TMH. |
%(TraceWpp.WppPreserveExtensions) | -preserveext:ext1[,ext2] |
|
ScanConfigurationData
Parametro stringa facoltativo. Cerca dati di configurazione, ad esempio tipi di dati personalizzati, in un file che non è un file di configurazione, nonché in defaultwpp.ini. |
%(TraceWpp.WppScanConfigurationData) | -scan:File |
|
SearchString
Parametro stringa facoltativo. Indirizza WPP per cercare i file di origine per la stringa specificata per avviare la traccia. |
%(TraceWpp.WppSearchString) | -lookfor:String |
|
Percorso utensile
Parametro stringa facoltativo. Consente di specificare il percorso completo della cartella in cui si trova lo strumento. |
$(WPPToolPath) | |
|
TraceFunction
Parametro string[] facoltativo. Specifica le funzioni che possono quindi essere usate per generare messaggi di traccia. |
%(TraceWpp.WppTraceFunction) | -func:FunctionDescription |
|
TrackerLogDirectory
Parametro stringa facoltativo. Directory di log per la scrittura di tlog. |
%(TraceWpp.WppTrackerLogDirectory) | |
|
TrackFileAccess
Parametro booleano facoltativo. Se true, tiene traccia dei modelli di accesso ai file per questa attività. |
$(TrackFileAccess) |