Ctrpp-Aufgabe
Das Windows Driver Kit (WDK) stellt die Ctrpp-Aufgabe bereit, damit Sie das ctrpp.exe-Tool ausführen können, wenn Sie Ihren Treiber mithilfe von MSBuild erstellen. Informationen zur Verwendung von ctrpp.exe finden Sie unter CTRPP.
MSBuild verwendet das Ctrpp-Element, um die Parameter für den Ctrpp-Task an ctrpp.exe zu senden. Das Ctrpp-Element in den Projektdateien greift auf die Elementmetadaten für ctrpp.exe zu.
Im folgenden Beispiel wird gezeigt, wie Sie die Metadaten in der .vcxproj-Datei bearbeiten.
<ItemGroup>
<Ctrpp Include="a.manifest">
<GenerateHeaderFileForCounter>true</GenerateHeaderFileForCounter>
<HeaderFileNameForCounter>c:\test\abc.h</HeaderFileNameForCounter>
</Ctrpp>
</ItemGroup>
Das folgende Beispiel zeigt den Befehlszeilenaufruf:
ctrpp.exe –ch "c:\test\abc.h" a.manifest
Im obigen Beispiel ruft MSBuild ctrpp.exe für die Datei a.manifest mit der Option –ch auf, da die Metadaten GenerateHeaderFileForCounter auf true festgelegt sind. Außerdem verwendet MSBuild die HeaderFileNameForCounter-Metadaten, um das Argument für die Option –ch anzugeben.
| Ctrpp-Vorgangsparameter | Elementmetadaten | Toolwechsel | BESCHREIBUNG |
|---|---|---|---|
| `Source` | @(Ctrpp) | Erforderlicher ITaskItem-Parameter. Gibt das zu verarbeitende Zählermanifest an. | |
| AddPrefix | %(Ctrpp.AddPrefix) | Präfix<> | Optionaler Zeichenfolgenparameter. Gibt das Präfix an, das den generierten Funktionen und Variablen hinzugefügt werden soll. |
| Abwärtskompatibilität | %(Ctrpp.BackwardCompatibility) | -backcompat | Optionaler boolescher Parameter. Generiert Code, der mit Betriebssystemen vor Windows 7 binär kompatibel ist. |
| EnableLegacy | %(Ctrpp.EnableLegacy) | -Hinterlassenschaft | Optionaler boolescher Parameter. Wird zur vorherigen ctrpp-Datei zurückgesetzt. Dieser Wechsel bewirkt, dass ctrpp vier Ausgabedateien generiert: zwei Headerdateien, eine Ressourcendatei und eine Quellcodedatei. Dies imitiert das Verhalten, das in früheren Versionen von ctrpp gefunden wurde. Die Optionen -o, -ch, -rc und -prefix können nicht in Verbindung mit -legacy verwendet werden. |
| GeneratedCounterFilesPath | %(Ctrpp.GeneratedCounterFilesPath) | -sumPath-Pfad<> | Optionaler Zeichenfolgenparameter. Gibt den Pfad zum Generieren von binären Leistungsindikatorendateien an. |
| GenerateHeaderFileForCounter | %(Ctrpp.GenerateHeaderFileForCounter) | Wenn dies auf true festgelegt ist, wird der Schalter -ch aktiviert. | |
| HeaderFileNameForCounter | %(Ctrpp.HeaderFileNameForCounter) | -ch-Dateiname<> | Optionaler Zeichenfolgenparameter. Generiert eine Headerdatei, die die Leistungsindikatornamen und -IDs enthält. |
| GenerateHeaderFileForProvider | %(Ctrpp.GenerateHeaderFileForProvider) | Wenn dies auf true festgelegt ist, wird der -o-Schalter aktiviert. | |
| HeaderFileNameForProvider | %(Ctrpp.HeaderFileNameForProvider) | -o<Dateiname> | Optionaler Zeichenfolgenparameter. Generiert eine Headerdatei für den Anbieter. |
| GenerateMemoryRoutines | %(Ctrpp.GenerateMemoryRoutines) | -MemoryRoutines | Optionaler boolescher Parameter. Generiert Speicherbelegung und kostenlose Routinevorlagen. |
| GenerateNotificationCallback | %(Ctrpp.GenerateNotificationCallback) | -NotificationCallback | Optionaler boolescher Parameter. Generiert eine angepasste Benachrichtigungsrückrufvorlage. Ähnlich dem Attribut "callback" im <provider-Element> . |
| GenerateResourceSourceFile | %(Ctrpp.GenerateResourceSourceFile) | Wenn dies auf true festgelegt ist, wird der Schalter -rc aktiviert. | |
| Resourcefilename | %(Ctrpp.ResourceFileName) | -rc-Dateiname<> | Optionaler Zeichenfolgenparameter. Generiert eine Ressourcenquelldatei. |
| GenerateSummaryGlobalFile | %(Ctrpp.GeneratedSummaryGlobalFile) | -Zusammenfassungspfad<> | Optionaler Zeichenfolgenparameter. Generiert eine binäre Zählerdatei pro Anbieter, die eine zusammenfassungsbasierte globale Datei GenSumResource.BIN. |