Partager via

Ctrpp task

Le Kit de pilotes Windows (WDK) fournit la tâche Ctrpp pour pouvoir exécuter l’outil ctrpp.exe lorsque vous générez votre pilote à l’aide de MSBuild. For information about using ctrpp.exe, see CTRPP.

MSBuild utilise l’élément Ctrpp pour envoyer les paramètres de la tâche Ctrpp à ctrpp.exe. L’élément Ctrpp dans les fichiers projet accède aux métadonnées de l’élément pour ctrpp.exe.

L’exemple suivant montre comment modifier les métadonnées dans le fichier .vcxproj.

<ItemGroup>
    <Ctrpp Include="a.manifest">
      <GenerateHeaderFileForCounter>true</GenerateHeaderFileForCounter>
      <HeaderFileNameForCounter>c:\test\abc.h</HeaderFileNameForCounter>
    </Ctrpp>
</ItemGroup>

L’exemple suivant montre l’appel de ligne de commande :

ctrpp.exe –ch "c:\test\abc.h" a.manifest

In the example above, MSBuild invokes ctrpp.exe on the file a.manifest, with the –ch option because the metadata GenerateHeaderFileForCounter is set to true. Also, MSBuild uses the HeaderFileNameForCounter metadata to specify the argument for the –ch option

Paramètre de tâche Ctrpp Item Metadata Tool Switch Description
Source @(Ctrpp) Paramètre ITaskItem obligatoire. Spécifie le manifeste du compteur à traiter.
AddPrefix %(Ctrpp.AddPrefix) -prefix<prefix> Paramètre de chaîne facultatif. Spécifie le préfixe à ajouter aux fonctions et aux variables générées.
BackwardCompatibility %(Ctrpp.BackwardCompatibility) -backcompat Paramètre booléen facultatif. Génère du code compatible binaire avec les systèmes d’exploitation antérieurs à Windows 7.
EnableLegacy %(Ctrpp.EnableLegacy) -Legacy Paramètre booléen facultatif. Rétablit le fichier ctrpp précédent. Ce commutateur entraîne la génération de quatre fichiers de sortie : deux fichiers d’en-tête, un fichier de ressources et un fichier de code source. Cela imite le comportement trouvé dans les versions précédentes de ctrpp. Les options -o, -ch, -rc et -prefix ne peuvent pas être utilisées conjointement avec -legacy.
GeneratedCounterFilesPath %(Ctrpp.GeneratedCounterFilesPath) -sumPath<path> Paramètre de chaîne facultatif. Spécifie le chemin d’accès pour générer des fichiers de compteur binaire par défaut.
GenerateHeaderFileForCounter %(Ctrpp.GenerateHeaderFileForCounter) Si cette valeur est définie sur true, elle active le commutateur -ch.
HeaderFileNameForCounter %(Ctrpp.HeaderFileNameForCounter) -ch<filename> Paramètre de chaîne facultatif. Génère un fichier d’en-tête qui contient les noms et id des compteurs.
GenerateHeaderFileForProvider %(Ctrpp.GenerateHeaderFileForProvider) Si cette valeur est définie sur true, elle active le commutateur -o.
HeaderFileNameForProvider %(Ctrpp.HeaderFileNameForProvider) -o<filename> Paramètre de chaîne facultatif. Génère le fichier d’en-tête pour le fournisseur.
GenerateMemoryRoutines %(Ctrpp.GenerateMemoryRoutines) -MemoryRoutines Paramètre booléen facultatif. Génère l’allocation de mémoire et les modèles de routine gratuits.
GenerateNotificationCallback %(Ctrpp.GenerateNotificationCallback) -NotificationCallback Paramètre booléen facultatif. Génère un modèle de rappel de notification personnalisé. Similaire à l’attribut « callback » dans l’élément <fournisseur> .
GenerateResourceSourceFile %(Ctrpp.GenerateResourceSourceFile) Si cette valeur est définie sur true, elle active le commutateur -rc.
ResourceFileName %(Ctrpp.ResourceFileName) -rc<filename> Paramètre de chaîne facultatif. Génère le fichier source de ressource.
GenerateSummaryGlobalFile %(Ctrpp.GeneratedSummaryGlobalFile) -summary<path> Paramètre de chaîne facultatif. Génère un fichier de compteur binaire par fournisseur qui génère des GenSumResource.BIN de fichiers globaux récapitulatives.

CTRPP

  • Last updated on