Windows 驱动程序工具包（WDK）提供 Ctrpp 任务，以便在使用 MSBuild 生成驱动程序时运行 ctrpp.exe 工具。 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> | 可选字符串参数。 生成包含计数器名称和 ID 的头文件。 |
| GenerateHeaderFileForProvider | %(Ctrpp.GenerateHeaderFileForProvider) | 如果设置为 true，则启用 -o 开关。 | |
| HeaderFileNameForProvider | %(Ctrpp.HeaderFileNameForProvider) | -o<filename> | 可选字符串参数。 为提供程序生成头文件。 |
| GenerateMemoryRoutines | %(Ctrpp.GenerateMemoryRoutines) | -MemoryRoutines | 可选的布尔参数。 生成内存分配和可用例程模板。 |
| GenerateNotificationCallback | %(Ctrpp.GenerateNotificationCallback) | -NotificationCallback | 可选的布尔参数。 生成自定义的通知回调模板。 类似于提供程序>元素中的<“callback”属性。 |
| GenerateResourceSourceFile | %(Ctrpp.GenerateResourceSourceFile) | 如果设置为 true，则启用 -rc 开关。 | |
| ResourceFileName | %(Ctrpp.ResourceFileName) | -rc<filename> | 可选字符串参数。 生成资源源文件。 |
| GenerateSummaryGlobalFile | %(Ctrpp.GeneratedSummaryGlobalFile) | -summary<path> | 可选字符串参数。 每个提供程序生成二进制计数器文件，GenSumResource.BIN生成摘要全局文件。 |