TraceWPP task

Le Kit de pilotes Windows (WDK) fournit la tâche TraceWPP pour pouvoir exécuter l’outil tracewpp.exe lorsque vous générez votre pilote à l’aide de MSBuild. L’outil tracewpp.exe est utilisé pour implémenter le suivi logiciel WPP.

WppEnabled est une nouvelle métadonnées pour l’élément ClCompile qui active le suivi pour les fichiers sources. 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.

Les métadonnées WppEnabled ont été ajoutées à l’élément ClCompile, car la tâche WPP s’exécute sur le même type de fichiers d’entrée que la tâche CL, dans ce cas .c, .cpp et les fichiers .h.

Note You access the Item metadata for tracewpp by using the ClCompile item in project files. MSBuild utilise l’élément TraceWpp en interne à l’intérieur de la cible pour le transmettre à la tâche.

L’exemple suivant montre comment modifier les métadonnées dans le fichier .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>

L’appel de ligne de commande serait :

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. Notez également que les métadonnées de ces deux entrées sont différentes. Par conséquent, les commutateurs seront également différents pour ces entrées. En d’autres termes, vous pouvez appeler chaque entrée avec son propre ensemble de métadonnées.

Paramètre de tâche WPP	Item Metadata	Tool Switch
Sources Paramètre ITaskItem[] obligatoire. Spécifie une liste de fichiers sources.	@(TraceWpp)
AddAlternateNameToMessageGUID Paramètre de chaîne facultatif. Spécifie un autre nom convivial pour le GUID de message pour les messages provenant de ce fournisseur de trace.	%(TraceWpp.WppAddAlternateNameToMessageGUID)	-o:String
AdditionalConfigurationFile Paramètre de chaîne facultatif. Spécifie un fichier de configuration supplémentaire. WPP utilise le fichier spécifié en plus du fichier par défaut, defaultwpp.ini.	%(TraceWpp.WppAdditionalConfigurationFile)	-ini:Path
AdditionalIncludeDirectories Paramètre string[] facultatif. Ajoute un répertoire à la liste des répertoires que WPP recherche pour inclure des fichiers.	%(TraceWpp.WppAdditionalIncludeDirectories)	-I
AlternateConfigurationFile Paramètre de chaîne facultatif. Spécifie un autre fichier de configuration. WPP utilise ce fichier au lieu du fichier defaultwpp.ini.	%(TraceWpp.WppAlternateConfigurationFile)	-defwpp:Path
GenerateUsingTemplateFile Paramètre de chaîne facultatif. Pour chaque fichier source que WPP traite avec le nom spécifié entre les accolades {}, WPP crée un autre fichier avec l’extension de nom de fichier spécifiée.	%(TraceWpp.WppGenerateUsingTemplateFile)	-gen{File.tpl}*.ext
MinimalRebuildFromTracking Paramètre booléen facultatif. If the value is TRUE, WPP performs a tracked incremental build. Sinon, WPP effectue une reconstruction.	%(TraceWpp.WppMinimalRebuildFromTracking)
NumericBaseForFormatStrings Paramètre int facultatif. Établit une base numérique pour la numérotation des chaînes de format.	%(TraceWpp.WppNumericBaseForFormatStrings)	-argbase:Number
AddControlGUID Paramètre de chaîne facultatif. Définit une macro WPP_CONTROL_GUIDS avec le GUID de contrôle spécifié et les entrées WPP_DEFINE_BIT nommées « Error », « Unusual » et « Noise ».	%(TraceWpp.WppAddControlGUID)	-ctl:GUID
AdditionalOptions Paramètre de chaîne facultatif. Liste des options de ligne de commande.	%(TraceWpp.WppAdditionalOptions)
ConfigurationDirectories Paramètre string[] facultatif. Spécifie l’emplacement des fichiers de configuration et de modèle.	%(TraceWpp.WppConfigurationDirectories)	-cfgdir:[Path]
DllMacro Paramètre booléen facultatif. Définit la macro WPP_DLL.	%(TraceWpp.WppDllMacro)	-dll
FileExtensions Paramètre string[] facultatif. Spécifie les types de fichiers que WPP reconnaît en tant que fichiers sources. WPP ignore les fichiers avec une autre extension de nom de fichier.	%(TraceWpp.WppFileExtensions)	-ext:.ext1 [.ext2]
IgnoreExclamationmarks Paramètre booléen facultatif. Dirige WPP pour ignorer les marques d’exclamation, également appelées « shrieks », utilisées dans la mise en forme complexe, comme % !timestamp !%.	%(TraceWpp.WppIgnoreExclamationmarks)	-noshrieks
KernelMode Paramètre booléen facultatif. Définit la macro WPP_KERNEL_MODE, qui trace les composants en mode noyau. Par défaut, seuls les composants en mode utilisateur sont suivis.	%(TraceWpp.WppKernelMode)	-km
OutputDirectory Paramètre de chaîne facultatif. Spécifie le répertoire des fichiers de sortie créés par WPP.	%(TraceWpp.WppOutputDirectory)	-odir:Path
PreprocessorDefinitions Paramètre string[] facultatif. Définit un symbole de prétraitement pour votre fichier source.	%(TraceWpp.WppPreprocessorDefinitions)	/D
PreserveExtensions Paramètre string[] facultatif. Conserve les extensions de nom de fichier spécifiées lors de la création de fichiers TMH.	%(TraceWpp.WppPreserveExtensions)	-preserveext:ext1[,ext2]
ScanConfigurationData Paramètre de chaîne facultatif. Recherche des données de configuration, telles que des types de données personnalisés, dans un fichier qui n’est pas un fichier de configuration, ainsi que dans defaultwpp.ini.	%(TraceWpp.WppScanConfigurationData)	-scan:File
SearchString Paramètre de chaîne facultatif. Dirige WPP pour rechercher les fichiers sources de la chaîne spécifiée pour lancer le suivi.	%(TraceWpp.WppSearchString)	-lookfor:String
ToolPath Paramètre de chaîne facultatif. Vous permet de spécifier le chemin complet du dossier où se trouve l’outil.	$(WPPToolPath)
TraceFunction Paramètre string[] facultatif. Spécifie les fonctions qui peuvent ensuite être utilisées pour générer des messages de trace.	%(TraceWpp.WppTraceFunction)	-func:FunctionDescription
TrackerLogDirectory Paramètre de chaîne facultatif. Répertoire de journal pour que le suivi écrive des tlogs.	%(TraceWpp.WppTrackerLogDirectory)
TrackFileAccess Paramètre booléen facultatif. Si la valeur est true, effectue le suivi des modèles d’accès aux fichiers pour cette tâche.	$(TrackFileAccess)

rubriques connexes

WPP Preprocessor

Suivi logiciel avec WPP