Ctrpp task

Das Windows Driver Kit (WDK) stellt die Ctrpp-Aufgabe bereit, sodass Sie das ctrpp.exe Tool ausführen können, wenn Sie Ihren Treiber mit MSBuild erstellen. For information about using ctrpp.exe, see CTRPP.

MSBuild verwendet das Ctrpp-Element, um die Parameter für die Ctrpp-Aufgabe an ctrpp.exezu senden. Das Ctrpp-Element in den Projektdateien greift auf die Elementmetadaten für ctrpp.exezu.

Das folgende Beispiel zeigt, wie Die Metadaten in der .vcxproj Datei bearbeitet werden.

<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

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

Ctrpp-Vorgangsparameter	Item Metadata	Tool Switch	Description
Source	@(Ctrpp)		Erforderlicher ITaskItem-Parameter. Gibt das zu verarbeitende Zählermanifest an.
AddPrefix	%(Ctrpp.AddPrefix)	-prefix<prefix>	Optionaler Zeichenfolgenparameter. Gibt das Präfix an, das den generierten Funktionen und Variablen hinzugefügt werden soll.
BackwardCompatibility	%(Ctrpp.BackwardCompatibility)	-backcompat	Optionaler boolescher Parameter. Generiert Code, der mit Betriebssystemen vor Windows 7 binär kompatibel ist.
EnableLegacy	%(Ctrpp.EnableLegacy)	-Legacy	Optionaler boolescher Parameter. Wird auf die vorherige CTRPP-Datei zurückgesetzt. Diese Option 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<path>	Optionaler Zeichenfolgenparameter. Gibt den Pfad zum Generieren von Binärzählerdateien an.
GenerateHeaderFileForCounter	%(Ctrpp.GenerateHeaderFileForCounter)		Wenn dies auf "true" festgelegt ist, wird der schalter -ch aktiviert.
HeaderFileNameForCounter	%(Ctrpp.HeaderFileNameForCounter)	-ch<filename>	Optionaler Zeichenfolgenparameter. Generiert eine Headerdatei, die die Zählernamen und IDs enthält.
GenerateHeaderFileForProvider	%(Ctrpp.GenerateHeaderFileForProvider)		Wenn dies auf "true" festgelegt ist, wird der schalter -o aktiviert.
HeaderFileNameForProvider	%(Ctrpp.HeaderFileNameForProvider)	-o<filename>	Optionaler Zeichenfolgenparameter. Generiert Die Headerdatei für den Anbieter.
GenerateMemoryRoutines	%(Ctrpp.GenerateMemoryRoutines)	-MemoryRoutines	Optionaler boolescher Parameter. Generiert Speicherzuweisungen und kostenlose Routinevorlagen.
GenerateNotificationCallback	%(Ctrpp.GenerateNotificationCallback)	-NotificationCallback	Optionaler boolescher Parameter. Generiert angepasste Benachrichtigungsrückrufvorlage. Ähnlich wie das Attribut "callback" im <Anbieterelement> .
GenerateResourceSourceFile	%(Ctrpp.GenerateResourceSourceFile)		Wenn dies auf "true" festgelegt ist, wird der schalter -rc aktiviert.
ResourceFileName	%(Ctrpp.ResourceFileName)	-rc<filename>	Optionaler Zeichenfolgenparameter. Generiert ressourcenquelldatei.
GenerateSummaryGlobalFile	%(Ctrpp.GeneratedSummaryGlobalFile)	-summary<path>	Optionaler Zeichenfolgenparameter. Generiert binäre Zählerdatei pro Anbieter generiert zusammenfassende globale Datei GenSumResource.BIN.

Verwandte Themen

CTRPP