Compartilhar via


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)

Pré-processador WPP

Rastreamento de software WPP