Ctrpp 任务
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生成摘要全局文件。 |