Tarefa Ctrpp
O WDK (Kit de Driver do Windows) fornece a tarefa Ctrpp para que você possa executar a ferramenta ctrpp.exe ao criar seu driver usando o MSBuild. Para obter informações sobre como usar ctrpp.exe, consulte CTRPP.
O MSBuild usa o Item Ctrpp para enviar os parâmetros da tarefa Ctrpp para ctrpp.exe. O item Ctrpp nos arquivos de projeto acessa os metadados do item para ctrpp.exe.
O exemplo a seguir mostra como editar os metadados no arquivo .vcxproj.
<ItemGroup>
<Ctrpp Include="a.manifest">
<GenerateHeaderFileForCounter>true</GenerateHeaderFileForCounter>
<HeaderFileNameForCounter>c:\test\abc.h</HeaderFileNameForCounter>
</Ctrpp>
</ItemGroup>
O exemplo a seguir mostra a invocação de linha de comando:
ctrpp.exe –ch "c:\test\abc.h" a.manifest
No exemplo acima, o MSBuild invoca ctrpp.exe no arquivo a.manifest, com a opção –ch porque os metadados GenerateHeaderFileForCounter estão definidos como true. Além disso, o MSBuild usa os metadados HeaderFileNameForCounter para especificar o argumento para a opção –ch
| Parâmetro da tarefa Ctrpp | Metadados de item | Comutador de Ferramentas | Descrição |
|---|---|---|---|
| Fonte | @(Ctrpp) | Parâmetro ITaskItem necessário. Especifica o manifesto do contador a ser processado. | |
| AddPrefix | %(Ctrpp.AddPrefix) | Prefixo -prefix<> | Parâmetro de cadeia de caracteres opcional. Especifica o prefixo a ser adicionado às funções e variáveis geradas. |
| BackwardCompatibility | %(Ctrpp.BackwardCompatibility) | -backcompat | Parâmetro Boolean opcional. Gera um código que é compatível binário com sistemas operacionais anteriores ao Windows 7. |
| EnableLegacy | %(Ctrpp.EnableLegacy) | -Legado | Parâmetro Boolean opcional. Reverte para o arquivo ctrpp anterior. Essa opção faz com que ctrpp gere quatro arquivos de saída: dois arquivos de cabeçalho, um arquivo de recurso e um arquivo de código-fonte. Isso imita o comportamento encontrado em versões anteriores do ctrpp. As opções -o, -ch, -rc e -prefixo não podem ser usadas em conjunto com -legacy. |
| GeneratedCounterFilesPath | %(Ctrpp.GeneratedCounterFilesPath) | -sumPath<path> | Parâmetro de cadeia de caracteres opcional. Especifica o caminho para gerar arquivos de contador binários padrão. |
| GenerateHeaderFileForCounter | %(Ctrpp.GenerateHeaderFileForCounter) | Se isso for definido como true, ele habilitará a opção -ch. | |
| HeaderFileNameForCounter | %(Ctrpp.HeaderFileNameForCounter) | -ch<filename> | Parâmetro de cadeia de caracteres opcional. Gera um arquivo de cabeçalho que contém os nomes e as IDs do contador. |
| GenerateHeaderFileForProvider | %(Ctrpp.GenerateHeaderFileForProvider) | Se isso for definido como true, ele habilitará a opção -o. | |
| HeaderFileNameForProvider | %(Ctrpp.HeaderFileNameForProvider) | -o<filename> | Parâmetro de cadeia de caracteres opcional. Gera o arquivo de cabeçalho para o provedor. |
| GenerateMemoryRoutines | %(Ctrpp.GenerateMemoryRoutines) | -MemoryRoutines | Parâmetro Boolean opcional. Gera alocação de memória e modelos de rotina livre. |
| GenerateNotificationCallback | %(Ctrpp.GenerateNotificationCallback) | -NotificationCallback | Parâmetro Boolean opcional. Gera um modelo de retorno de chamada de notificação personalizado. Semelhante ao atributo "callback" no elemento provider<>. |
| GenerateResourceSourceFile | %(Ctrpp.GenerateResourceSourceFile) | Se isso for definido como true, ele habilitará a opção -rc. | |
| Resourcefilename | %(Ctrpp.ResourceFileName) | -rc<filename> | Parâmetro de cadeia de caracteres opcional. Gera o arquivo de origem do recurso. |
| GenerateSummaryGlobalFile | %(Ctrpp.GeneratedSummaryGlobalFile) | -summary<path> | Parâmetro de cadeia de caracteres opcional. Gera um arquivo de contador binário por provedor que gera GenSumResource.BIN de arquivo global de resumo. |