Tâche TraceWPP

Le Kit de pilotes Windows (WDK) fournit la tâche TraceWPP afin que vous puissiez 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 des fichiers sources. La tâche Wpp s’exécute sur l’ensemble des collections d’éléments ClCompile et appelle tracewpp.exe pour chaque élément pour lequel les métadonnées WppEnabled sont définies sur 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, en l’occurrence les fichiers .c, .cpp et .h.

Note Vous accédez aux métadonnées d’élément pour tracewpp à l’aide de l’élément ClCompile dans les fichiers projet. 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

L’exemple ci-dessus montre que MSBuild appelle tracewpp.exe uniquement sur b.c et test2.c, car les métadonnées WppEnabled sont définies sur TRUE pour ces entrées. 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	Métadonnées d’élément	Commutateur d’outils
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 qui proviennent de ce fournisseur de traces.	%(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 les fichiers Include.	%(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. Si la valeur est TRUE, WPP effectue une build incrémentielle suivie. Sinon, WPP effectue une reconstruction.	%(TraceWpp.WppMinimalRebuildFromTracking)
NumericBaseForFormatStrings Paramètre Entier 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 WPP_DEFINE_BIT entrées 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 comme fichiers sources. WPP ignore les fichiers avec une extension de nom de fichier différente.	%(TraceWpp.WppFileExtensions)	-ext :.ext1 [.ext2]
IgnoreExclamationmarks Paramètre booléen facultatif. Indique à WPP d’ignorer les points d’exclamation, également appelés « cris », utilisés 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 les données de configuration, telles que les 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. Indique à WPP de rechercher dans les fichiers sources 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 d’accès complet au 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 des journaux pour que le tracker écrive des journaux.	%(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

Préprocesseur WPP

Suivi logiciel WPP