Ctrpp task

Sada Windows Driver Kit (WDK) poskytuje úlohu Ctrpp, abyste mohli spustit nástroj ctrpp.exe při sestavování ovladače pomocí nástroje MSBuild. For information about using ctrpp.exe, see CTRPP.

Nástroj MSBuild používá Ctrpp Item k odeslání parametrů pro úlohu Ctrpp do ctrpp.exe. Položka Ctrpp v souborech projektu přistupuje k metadatům položky pro ctrpp.exe.

Následující příklad ukazuje, jak upravit metadata v souboru .vcxproj.

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

Následující příklad ukazuje vyvolání příkazového řádku:

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

Parametr úlohy Ctrpp	Item Metadata	Tool Switch	Description
Source	@(Ctrpp)		Povinný parametr ITaskItem. Určuje manifest čítače, který se má zpracovat.
AddPrefix	%(Ctrpp.AddPrefix)	-prefix<prefix>	Volitelný parametr řetězce. Určuje předponu, která se má přidat do funkcí a vygenerovaných proměnných.
BackwardCompatibility	%(Ctrpp.BackwardCompatibility)	-backcompat	Volitelný logický parametr. Vygeneruje kód, který je binární kompatibilní s operačními systémy před Windows 7.
EnableLegacy	%(Ctrpp.EnableLegacy)	-Legacy	Volitelný logický parametr. Vrátí se k předchozímu souboru ctrpp. Tento přepínač způsobí, že ctrpp vygeneruje čtyři výstupní soubory: dva soubory hlaviček, soubor prostředků a soubor zdrojového kódu. Toto napodobuje chování zjištěné v předchozích verzích ctrpp. Možnosti -o, -ch, -rc a -prefix nelze použít ve spojení s parametrem -legacy.
GeneratedCounterFilesPath	%(Ctrpp.GeneratedCounterFilesPath)	-sumPath<path>	Volitelný parametr řetězce. Určuje cestu k vygenerování výchozích binárních souborů čítačů.
GenerateHeaderFileForCounter	%(Ctrpp.GenerateHeaderFileForCounter)		Pokud je nastavená hodnota true, povolí se přepínač -ch.
HeaderFileNameForCounter	%(Ctrpp.HeaderFileNameForCounter)	-ch<filename>	Volitelný parametr řetězce. Vygeneruje soubor hlaviček, který obsahuje názvy a ID čítačů.
GenerateHeaderFileForProvider	%(Ctrpp.GenerateHeaderFileForProvider)		Pokud je nastavená hodnota true, povolí se přepínač -o.
HeaderFileNameForProvider	%(Ctrpp.HeaderFileNameForProvider)	-o<filename>	Volitelný parametr řetězce. Vygeneruje soubor hlaviček pro zprostředkovatele.
GenerateMemoryRoutines	%(Ctrpp.GenerateMemoryRoutines)	-MemoryRoutines	Volitelný logický parametr. Generuje přidělení paměti a bezplatné šablony rutin.
GenerateNotificationCallback	%(Ctrpp.GenerateNotificationCallback)	-NotificationCallback	Volitelný logický parametr. Generuje přizpůsobenou šablonu zpětného volání oznámení. Podobá se atributu "callback" v elementu <provider> .
GenerateResourceSourceFile	%(Ctrpp.GenerateResourceSourceFile)		Pokud je nastavená hodnota true, povolí se přepínač -rc.
ResourceFileName	%(Ctrpp.ResourceFileName)	-rc<filename>	Volitelný parametr řetězce. Generuje zdrojový soubor prostředku.
GenerateSummaryGlobalFile	%(Ctrpp.GeneratedSummaryGlobalFile)	-summary<path>	Volitelný parametr řetězce. Generuje binární soubor čítače na zprostředkovatele vygeneruje souhrnný globální soubor GenSumResource.BIN.

související témata

CTRPP