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

CTRPP