Ctrpp task

Пакет драйверов Windows (WDK) предоставляет задачу Ctrpp, чтобы вы могли запустить средство ctrpp.exe при сборке драйвера с помощью MSBuild. For information about using ctrpp.exe, see CTRPP.

MSBuild использует элемент Ctrpp для отправки параметров для задачи Ctrpp в ctrpp.exe. Элемент Ctrpp в файлах проекта обращается к метаданным элемента для ctrpp.exe.

В следующем примере показано, как изменить метаданные в файле .vcxproj.

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

В следующем примере показан вызов командной строки:

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	Item Metadata	Tool Switch	Description
Source	@(Ctrpp)		Обязательный параметр ITaskItem. Указывает манифест счетчика для обработки.
AddPrefix	%(Ctrpp.AddPrefix)	-prefix<prefix>	Необязательный строковый параметр. Указывает префикс, добавляемый в созданные функции и переменные.
BackwardCompatibility	%(Ctrpp.BackwardCompatibility)	-backcompat	Необязательный логический параметр. Создает код, совместимый с двоичными системами до Windows 7.
EnableLegacy	%(Ctrpp.EnableLegacy)	-Legacy	Необязательный логический параметр. Возвращается к предыдущему файлу ctrpp. Этот параметр приводит к созданию четырех выходных файлов ctrpp: двух файлов заголовков, файла ресурсов и файла исходного кода. Это имитирует поведение, найденного в предыдущих версиях ctrpp. Параметры -o, -ch, -rc и -prefix нельзя использовать в сочетании с -legacy.
GeneratedCounterFilesPath	%(Ctrpp.GeneratedCounterFilesPath)	-sumPath<path>	Необязательный строковый параметр. Указывает путь для создания двоичных файлов счетчиков по умолчанию.
GenerateHeaderFileForCounter	%(Ctrpp.GenerateHeaderFileForCounter)		Если задано значение true, он включает параметр -ch.
HeaderFileNameForCounter	%(Ctrpp.HeaderFileNameForCounter)	-ch<filename>	Необязательный строковый параметр. Создает файл заголовка, содержащий имена счетчиков и идентификаторы.
GenerateHeaderFileForProvider	%(Ctrpp.GenerateHeaderFileForProvider)		Если задано значение true, он включает параметр -o.
HeaderFileNameForProvider	%(Ctrpp.HeaderFileNameForProvider)	-o<filename>	Необязательный строковый параметр. Создает файл заголовка для поставщика.
GenerateMemoryRoutines	%(Ctrpp.GenerateMemoryRoutines)	-MemoryRoutines	Необязательный логический параметр. Создает выделение памяти и бесплатные шаблоны подпрограмм.
GenerateNotificationCallback	%(Ctrpp.GenerateNotificationCallback)	-NotificationCallback	Необязательный логический параметр. Создает настраиваемый шаблон обратного вызова уведомлений. Аналогично атрибуту "обратный вызов" в элементе <provider> .
GenerateResourceSourceFile	%(Ctrpp.GenerateResourceSourceFile)		Если задано значение true, он включает параметр -rc.
ResourceFileName	%(Ctrpp.ResourceFileName)	-rc<filename>	Необязательный строковый параметр. Создает исходный файл ресурса.
GenerateSummaryGlobalFile	%(Ctrpp.GeneratedSummaryGlobalFile)	-summary<path>	Необязательный строковый параметр. Создает файл двоичного счетчика для каждого поставщика, создающий сводку глобальных файлов GenSumResource.BIN.

Связанные разделы

CTRPP