Compartilhar via

Ctrpp task

O WDK (Windows Driver Kit) fornece a tarefa Ctrpp para que você possa executar a ferramenta ctrpp.exe ao criar seu driver usando o MSBuild. For information about using ctrpp.exe, see 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

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

Parâmetro da tarefa Ctrpp Item Metadata Tool Switch Description
Source @(Ctrpp) Parâmetro ITaskItem necessário. Especifica o manifesto do contador a ser processado.
AddPrefix %(Ctrpp.AddPrefix) -prefix<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 booliano opcional. Gera um código compatível binário com sistemas operacionais antes do Windows 7.
EnableLegacy %(Ctrpp.EnableLegacy) -Legacy Parâmetro booliano opcional. Reverte para o arquivo ctrpp anterior. Essa opção faz com que o 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 -prefix 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ário 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 booliano opcional. Gera alocação de memória e modelos de rotina gratuitos.
GenerateNotificationCallback %(Ctrpp.GenerateNotificationCallback) -NotificationCallback Parâmetro booliano opcional. Gera um modelo de retorno de chamada de notificação personalizado. Semelhante ao atributo "retorno de chamada" no elemento do <provedor> .
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 e gera GenSumResource.BIN de arquivo global de resumo.

CTRPP

  • Last updated on