Windows 驱动程序工具包 (WDK) 提供 Ctrpp 任务，以便你可以在使用 MSBuild 生成驱动程序时运行 ctrpp.exe 工具。 有关使用 ctrpp.exe 的信息，请参阅 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
在上面的示例中，MSBuild 使用 –ch 选项调用文件 a.manifest 上的 ctrpp.exe，因为元数据 GenerateHeaderFileForCounter 设置为 true。 此外，MSBuild 使用 HeaderFileNameForCounter 元数据指定 –ch 选项的参数
| Ctrpp 任务参数 | 项元数据 | 工具开关 | 说明 |
|---|---|---|---|
| 源 | @ (Ctrpp) | 必需的 ITaskItem 参数。 指定要处理的计数器清单。 | |
| AddPrefix | % (Ctrpp.AddPrefix) | -prefix<prefix> | 可选字符串参数。 指定要添加到生成的函数和变量的前缀。 |
| 向后兼容性 | % (Ctrpp.BackwardCompatibility) | -backcompat | 可选的布尔参数。 生成与 Windows 7 之前的操作系统兼容的二进制代码。 |
| EnableLegacy | % (Ctrpp.EnableLegacy) | -遗产 | 可选的布尔参数。 还原到上一个 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生成摘要全局文件。 |