Tarefa TraceWPP

O WDK (Windows Driver Kit) fornece a tarefa TraceWPP para que você possa executar a ferramenta tracewpp.exe ao criar seu driver usando o MSBuild. A ferramenta tracewpp.exe é usada para implementar o Rastreamento de Software WPP.

WppEnabled é um novo metadado para o item ClCompile que permite o rastreamento de arquivos de origem. A tarefa Wpp é executada por todas as Coleções de Itens ClCompile e invoca tracewpp.exe para cada Item para o qual os metadados WppEnabled são definidos como TRUE.

Os metadados WppEnabled foram adicionados ao Item ClCompile porque a tarefa WPP é executada no mesmo tipo de arquivos de entrada que a tarefa CL, nesse caso , arquivos .c, .cpp e .h.

Nota Você acessa os metadados de item para tracewpp usando o item ClCompile em arquivos de projeto. O MSBuild usa o item TraceWpp internamente dentro do destino para passá-lo para a tarefa.

O exemplo a seguir mostra como editar os metadados no arquivo .vcxproj.

<ItemGroup>
    <ClCompile Include="a.c" />
      <WppEnabled>false</WppEnabled>
    <ClCompile Include="b.c">
        <WppEnabled>true</WppEnabled>
        <WppKernelMode>true</WppKernelMode>
        <WppAdditionalIncludeDirectories>c:\test\</WppAdditionalIncludeDirectories>
    </ClCompile>
    <ClCompile Include="test1.c" />
    <ClCompile Include="test2.c">
        <WppEnabled>true</WppEnabled>
        <WppDllMacro>true</WppDllMacro>
    </ClCompile>
</ItemGroup>

A invocação de linha de comando seria:

tracewpp.exe  km /Ic:\test\b.c
tracewpp.exe  dll test2.c

O exemplo acima mostra que o MSBuild invoca tracewpp.exe somente em b.c e test2.c porque os metadados WppEnabled são definidos como TRUE para essas entradas. Observe também que os metadados dessas duas entradas são diferentes. Portanto, as opções também serão diferentes para essas entradas. Em outras palavras, você pode chamar cada entrada com seu próprio conjunto de metadados.

Parâmetro da tarefa WPP	Metadados de item	Comutador de Ferramentas
Fontes Parâmetro obrigatório ITaskItem[]. Especifica uma lista de arquivos de origem.	@(TraceWpp)
AddAlternateNameToMessageGUID Parâmetro de cadeia de caracteres opcional. Especifica um nome amigável alternativo para o GUID da mensagem para mensagens provenientes desse provedor de rastreamento.	%(TraceWpp.WppAddAlternateNameToMessageGUID)	-o:String
AdditionalConfigurationFile Parâmetro de cadeia de caracteres opcional. Especifica um arquivo de configuração adicional. O WPP usa o arquivo especificado além do arquivo padrão, defaultwpp.ini.	%(TraceWpp.WppAdditionalConfigurationFile)	-ini:Path
AdditionalIncludeDirectories Parâmetro string[] opcional. Adiciona um diretório à lista de diretórios que o WPP pesquisa para incluir arquivos.	%(TraceWpp.WppAdditionalIncludeDirectories)	-I
AlternateConfigurationFile Parâmetro de cadeia de caracteres opcional. Especifica um arquivo de configuração alternativo. O WPP usa esse arquivo em vez do arquivo defaultwpp.ini.	%(TraceWpp.WppAlternateConfigurationFile)	-defwpp:Path
GenerateUsingTemplateFile Parâmetro de cadeia de caracteres opcional. Para cada arquivo de origem que o WPP processa com o nome especificado entre as chaves {}, o WPP cria outro arquivo com a extensão de nome de arquivo especificada.	%(TraceWpp.WppGenerateUsingTemplateFile)	-gen{File.tpl}*.ext
MinimalRebuildFromTracking Parâmetro Boolean opcional. Se o valor for TRUE, o WPP executará um build incremental rastreado. Caso contrário, o WPP executará uma recompilação.	%(TraceWpp.WppMinimalRebuildFromTracking)
NumericBaseForFormatStrings Parâmetro int opcional. Estabelece uma base numérica para a numeração de cadeias de caracteres de formato.	%(TraceWpp.WppNumericBaseForFormatStrings)	-argbase:Number
AddControlGUID Parâmetro de cadeia de caracteres opcional. Define uma macro WPP_CONTROL_GUIDS com as entradas de guid de controle e WPP_DEFINE_BIT especificadas chamadas 'Error', 'Unusual' e 'Noise'.	%(TraceWpp.WppAddControlGUID)	-ctl:GUID
AdditionalOptions Parâmetro de cadeia de caracteres opcional. Uma lista de opções de linha de comando.	%(TraceWpp.WppAdditionalOptions)
ConfigurationDirectories Parâmetro string[] opcional. Especifica o local dos arquivos de configuração e modelo.	%(TraceWpp.WppConfigurationDirectories)	-cfgdir:[Caminho]
DllMacro Parâmetro Boolean opcional. Define a macro WPP_DLL.	%(TraceWpp.WppDllMacro)	-Dll
FileExtensions Parâmetro string[] opcional. Especifica os tipos de arquivo que o WPP reconhece como arquivos de origem. O WPP ignora arquivos com uma extensão de nome de arquivo diferente.	%(TraceWpp.WppFileExtensions)	-ext:.ext1 [.ext2]
IgnoreExclamationmarks Parâmetro Boolean opcional. Orienta o WPP a ignorar pontos de exclamação, também conhecidos como "gritos", usados em formatação complexa, como %!timestamp!%.	%(TraceWpp.WppIgnoreExclamationmarks)	-noshrieks
KernelMode Parâmetro Boolean opcional. Define a macro WPP_KERNEL_MODE, que rastreia componentes do modo kernel. Por padrão, somente os componentes do modo de usuário são rastreados.	%(TraceWpp.WppKernelMode)	-km
OutputDirectory Parâmetro de cadeia de caracteres opcional. Especifica o diretório para os arquivos de saída que o WPP cria.	%(TraceWpp.WppOutputDirectory)	-odir:Path
PreprocessorDefinitions Parâmetro string[] opcional. Define um símbolo de pré-processamento para seu arquivo de origem.	%(TraceWpp.WppPreprocessorDefinitions)	/D
PreserveExtensions Parâmetro string[] opcional. Preserva as extensões de nome de arquivo especificadas ao criar arquivos TMH.	%(TraceWpp.WppPreserveExtensions)	-preserveext:ext1[,ext2]
ScanConfigurationData Parâmetro de cadeia de caracteres opcional. Pesquisa dados de configuração, como tipos de dados personalizados, em um arquivo que não é um arquivo de configuração, bem como em defaultwpp.ini.	%(TraceWpp.WppScanConfigurationData)	-scan:File
Searchstring Parâmetro de cadeia de caracteres opcional. Direciona o WPP para pesquisar os arquivos de origem para que a cadeia de caracteres especificada inicie o rastreamento.	%(TraceWpp.WppSearchString)	-lookfor:String
ToolPath Parâmetro de cadeia de caracteres opcional. Permite que você especifique o caminho completo para a pasta em que a ferramenta está localizada.	$(WPPToolPath)
TraceFunction Parâmetro string[] opcional. Especifica funções que podem ser usadas para gerar mensagens de rastreamento.	%(TraceWpp.WppTraceFunction)	-func:FunctionDescription
TrackerLogDirectory Parâmetro de cadeia de caracteres opcional. Diretório de log para o rastreador gravar tlogs.	%(TraceWpp.WppTrackerLogDirectory)
TrackFileAccess Parâmetro Boolean opcional. Se for true, rastreará os padrões de acesso a arquivos para essa tarefa.	$(TrackFileAccess)

Tópicos relacionados

Pré-processador WPP

Rastreamento de software WPP