Ctrpp task

De Windows Driver Kit (WDK) biedt de Ctrpp-taak, zodat u het hulpprogramma ctrpp.exe kunt uitvoeren wanneer u uw stuurprogramma bouwt met BEHULP van MSBuild. For information about using ctrpp.exe, see CTRPP.

MSBuild gebruikt het Ctrpp-item om de parameters voor de Ctrpp-taak te verzenden naar ctrpp.exe. Het Ctrpp-item in de projectbestanden opent de metagegevens van het item voor ctrpp.exe.

In het volgende voorbeeld ziet u hoe u de metagegevens in het .vcxproj-bestand bewerkt.

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

In het volgende voorbeeld ziet u de aanroep van de opdrachtregel:

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-taakparameter	Item Metadata	Tool Switch	Description
Source	@(Ctrpp)		Vereiste ITaskItem-parameter. Hiermee geeft u het tellermanifest dat moet worden verwerkt.
AddPrefix	%(Ctrpp.AddPrefix)	-prefix<prefix>	Optionele tekenreeksparameter. Hiermee geeft u het voorvoegsel op dat moet worden toegevoegd aan functies en variabelen die worden gegenereerd.
BackwardCompatibility	%(Ctrpp.BackwardCompatibility)	-backcompat	Optionele Booleaanse parameter. Genereert code die binair compatibel is met besturingssystemen vóór Windows 7.
EnableLegacy	%(Ctrpp.EnableLegacy)	-Legacy	Optionele Booleaanse parameter. Wordt teruggezet naar het vorige ctrpp-bestand. Deze schakeloptie zorgt ervoor dat ctrpp vier uitvoerbestanden genereert: twee headerbestanden, een resourcebestand en een broncodebestand. Dit nabootst het gedrag dat in eerdere versies van ctrpp is gevonden. De opties -o, -ch, -rc en -prefix kunnen niet worden gebruikt in combinatie met -legacy.
GeneratedCounterFilesPath	%(Ctrpp.GeneratedCounterFilesPath)	-sumPath<path>	Optionele tekenreeksparameter. Hiermee geeft u het pad voor het genereren van binaire tellerbestanden standaard.
GenerateHeaderFileForCounter	%(Ctrpp.GenerateHeaderFileForCounter)		Als dit is ingesteld op true, wordt de -ch switch ingeschakeld.
HeaderFileNameForCounter	%(Ctrpp.HeaderFileNameForCounter)	-ch<filename>	Optionele tekenreeksparameter. Hiermee wordt een headerbestand gegenereerd dat de tellernamen en id's bevat.
GenerateHeaderFileForProvider	%(Ctrpp.GenerateHeaderFileForProvider)		Als dit is ingesteld op true, wordt de -o switch ingeschakeld.
HeaderFileNameForProvider	%(Ctrpp.HeaderFileNameForProvider)	-o<filename>	Optionele tekenreeksparameter. Hiermee genereert u een headerbestand voor de provider.
GenerateMemoryRoutines	%(Ctrpp.GenerateMemoryRoutines)	-MemoryRoutines	Optionele Booleaanse parameter. Genereert geheugentoewijzing en gratis routinesjablonen.
GenerateNotificationCallback	%(Ctrpp.GenerateNotificationCallback)	-NotificationCallback	Optionele Booleaanse parameter. Hiermee genereert u een aangepaste callback-sjabloon voor meldingen. Vergelijkbaar met het kenmerk callback in het <providerelement> .
GenerateResourceSourceFile	%(Ctrpp.GenerateResourceSourceFile)		Als dit is ingesteld op true, wordt de -rc switch ingeschakeld.
ResourceFileName	%(Ctrpp.ResourceFileName)	-rc<filename>	Optionele tekenreeksparameter. Genereert het bronbestand van de resource.
GenerateSummaryGlobalFile	%(Ctrpp.GeneratedSummaryGlobalFile)	-summary<path>	Optionele tekenreeksparameter. Hiermee genereert u een binair tellerbestand per provider voor het genereren van een globaal overzichtsbestand GenSumResource.BIN.

verwante onderwerpen

CTRPP