Partilhar via

Ctrpp task

O Kit de Driver do Windows (WDK) fornece a tarefa Ctrpp para que você possa executar a ferramenta ctrpp.exe quando você cria o driver usando o MSBuild. For information about using ctrpp.exe, see CTRPP.

MSBuild usa o item Ctrpp para enviar os parâmetros para a 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 chamada 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 booleano opcional. Gera código binário compatível com sistemas operacionais anteriores ao Windows 7.
EnableLegacy %(Ctrpp.EnableLegacy) -Legacy Parâmetro booleano 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á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 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 booleano opcional. Gera alocação de memória e modelos de rotina gratuitos.
GenerateNotificationCallback %(Ctrpp.GenerateNotificationCallback) -NotificationCallback Parâmetro booleano 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 arquivo de contador binário por provedor, gera GenSumResource.BIN de arquivo global resumido.

CTRPP

  • Last updated on