Attività Ctrpp
Windows Driver Kit (WDK) fornisce l'attività Ctrpp in modo da poter eseguire lo strumento ctrpp.exe quando si compila il driver usando MSBuild. Per informazioni sull'uso di ctrpp.exe, vedere CTRPP.
MSBuild usa l'elemento Ctrpp per inviare i parametri per l'attività Ctrpp a ctrpp.exe. L'elemento Ctrpp nei file di progetto accede ai metadati dell'elemento per ctrpp.exe.
Nell'esempio seguente viene illustrato come modificare i metadati nel file .vcxproj.
<ItemGroup>
<Ctrpp Include="a.manifest">
<GenerateHeaderFileForCounter>true</GenerateHeaderFileForCounter>
<HeaderFileNameForCounter>c:\test\abc.h</HeaderFileNameForCounter>
</Ctrpp>
</ItemGroup>
L'esempio seguente mostra la chiamata della riga di comando:
ctrpp.exe –ch "c:\test\abc.h" a.manifest
Nell'esempio precedente, MSBuild richiama ctrpp.exe nel file a.manifest, con l'opzione –ch perché i metadati GenerateHeaderFileForCounter sono impostati su true. Inoltre, MSBuild usa i metadati HeaderFileNameForCounter per specificare l'argomento per l'opzione –ch
| Parametro attività Ctrpp | Metadati degli elementi | Opzione strumento | Descrizione |
|---|---|---|---|
| Source (Sorgente) | @(Ctrpp) | Parametro ITaskItem obbligatorio. Specifica il manifesto del contatore da elaborare. | |
| AddPrefix | %(Ctrpp.AddPrefix) | Prefisso -prefix<> | Parametro stringa facoltativo. Specifica il prefisso da aggiungere alle funzioni e alle variabili generate. |
| Retrocompatibilità | %(Ctrpp.BackwardCompatibility) | -backcompat | Parametro booleano facoltativo. Genera codice compatibile con i sistemi operativi precedenti a Windows 7. |
| EnableLegacy | %(Ctrpp.EnableLegacy) | -Eredità | Parametro booleano facoltativo. Ripristina il file ctrpp precedente. Questa opzione fa sì che ctrpp generi quattro file di output: due file di intestazione, un file di risorse e un file di codice sorgente. Questo simula il comportamento rilevato nelle versioni precedenti di ctrpp. Le opzioni -o, -ch, -rc e -prefix non possono essere usate insieme a -legacy. |
| GeneratedCounterFilesPath | %(Ctrpp.GeneratedCounterFilesPath) | -sumPath<path> | Parametro stringa facoltativo. Specifica il percorso per generare i file dei contatori binari predefiniti. |
| GenerateHeaderFileForCounter | %(Ctrpp.GenerateHeaderFileForCounter) | Se è impostato su true, abilita l'opzione -ch. | |
| HeaderFileNameForCounter | %(Ctrpp.HeaderFileNameForCounter) | -ch<filename> | Parametro stringa facoltativo. Genera un file di intestazione contenente i nomi e gli ID dei contatori. |
| GenerateHeaderFileForProvider | %(Ctrpp.GenerateHeaderFileForProvider) | Se è impostato su true, abilita l'opzione -o. | |
| HeaderFileNameForProvider | %(Ctrpp.HeaderFileNameForProvider) | -o<filename> | Parametro stringa facoltativo. Genera il file di intestazione per il provider. |
| GenerateMemoryRoutines | %(Ctrpp.GenerateMemoryRoutines) | -MemoryRoutines | Parametro booleano facoltativo. Genera modelli di allocazione di memoria e routine libera. |
| GenerateNotificationCallback | %(Ctrpp.GenerateNotificationCallback) | -NotificationCallback | Parametro booleano facoltativo. Genera un modello di callback di notifica personalizzato. Simile all'attributo "callback" nell'elemento <provider> . |
| GenerateResourceSourceFile | %(Ctrpp.GenerateResourceSourceFile) | Se è impostato su true, abilita l'opzione -rc. | |
| ResourceFileName | %(Ctrpp.ResourceFileName) | -rc<filename> | Parametro stringa facoltativo. Genera il file di origine delle risorse. |
| GenerateSummaryGlobalFile | %(Ctrpp.GeneratedSummaryGlobalFile) | -summary<path> | Parametro stringa facoltativo. Genera un file di contatore binario per provider che genera GenSumResource.BIN di file globali di riepilogo. |