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)

Argomenti correlati

Preprocessore WPP

Traccia software WPP