Tâche Ctrpp
Le Kit de pilotes Windows (WDK) fournit la tâche Ctrpp afin que vous puissiez exécuter l’outil ctrpp.exe lorsque vous générez votre pilote à l’aide de MSBuild. Pour plus d’informations sur l’utilisation de ctrpp.exe, consultez 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 d’é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
Dans l’exemple ci-dessus, MSBuild appelle ctrpp.exe sur le fichier a.manifest, avec l’option –ch , car les métadonnées GenerateHeaderFileForCounter ont la valeur true. En outre, MSBuild utilise les métadonnées HeaderFileNameForCounter pour spécifier l’argument de l’option –ch
| Paramètre de tâche Ctrpp | Métadonnées d’élément | Commutateur d’outils | Description |
|---|---|---|---|
| Source | @(Ctrpp) | Paramètre ITaskItem requis. Spécifie le manifeste de compteur à traiter. | |
| AddPrefix | %(Ctrpp.AddPrefix) | -préfixe<> | Paramètre de chaîne facultatif. Spécifie le préfixe à ajouter aux fonctions et variables générées. |
| Compatibilité descendante | %(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) | -Héritage | Paramètre booléen facultatif. Rétablit le fichier ctrpp précédent. Ce commutateur permet à ctrpp de générer 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 -préfixe ne peuvent pas être utilisées conjointement avec -legacy. |
| GeneratedCounterFilesPath | %(Ctrpp.GeneratedCounterFilesPath) | Chemin d’accès>-sumPath< | Paramètre de chaîne facultatif. Spécifie le chemin d’accès pour générer les fichiers de compteur binaires 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é. Semblable à l’attribut « rappel » dans l’élément <provider> . |
| GenerateResourceSourceFile | %(Ctrpp.GenerateResourceSourceFile) | Si cette valeur est définie sur true, elle active le commutateur -rc. | |
| ResourceFileName | %(Ctrpp.ResourceFileName) | Nom defichier> -rc< | Paramètre de chaîne facultatif. Génère le fichier source de ressources. |
| GenerateSummaryGlobalFile | %(Ctrpp.GeneratedSummaryGlobalFile) | Chemin d’accès>-summary< | Paramètre de chaîne facultatif. Génère un fichier de compteur binaire par fournisseur pour générer des GenSumResource.BIN de fichiers globaux récapitulatives. |