Partilhar via

TraceWPP task

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

WppEnabled é um novo metadados para o item ClCompile que permite o rastreamento de arquivos de origem. The Wpp task runs through the entire ClCompile Item Collections and invokes tracewpp.exe for each Item for which the WppEnabled metadata is set to 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, neste caso arquivos .c, .cpp e .h.

Note You access the Item metadata for tracewpp by using the ClCompile item in project files. 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

The example above shows that MSBuild invokes tracewpp.exe only on b.c and test2.c because the WppEnabled metadata is set to TRUE for these inputs. Observe também que os metadados para essas duas entradas são diferentes. Portanto, os switches 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 Item Metadata Tool Switch
Sources

Parâmetro ITaskItem[] necessário. 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. WPP usa o arquivo especificado além do arquivo padrão, defaultwpp.ini.

 %(TraceWpp.WppAdditionalConfigurationFile) -ini:Path
AdditionalIncludeDirectories

Parâmetro opcional string[]. Adiciona um diretório à lista de diretórios que o WPP procura por arquivos de inclusão.

 %(TraceWpp.WppAdditionalIncludeDirectories) -I
AlternateConfigurationFile

Parâmetro de cadeia de caracteres opcional. Especifica um arquivo de configuração alternativo. 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 booleano opcional. If the value is TRUE, WPP performs a tracked incremental build. Caso contrário, o WPP executa uma reconstruçã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 o GUID de controle especificado e WPP_DEFINE_BIT entradas chamadas 'Erro', 'Incomum' e 'Ruído'.

 %(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 opcional string[]. Especifica o local dos arquivos de configuração e modelo.

 %(TraceWpp.WppConfigurationDirectories) -cfgdir:[Path]
DllMacro

Parâmetro booleano opcional. Define a macro WPP_DLL.

 %(TraceWpp.WppDllMacro) -dll
FileExtensions

Parâmetro opcional string[]. Especifica os tipos de arquivo que o WPP reconhece como arquivos de origem. WPP ignora arquivos com uma extensão de nome de arquivo diferente.

 %(TraceWpp.WppFileExtensions) -ext:.ext1 [.ext2]
IgnoreExclamationmarks

Parâmetro booleano opcional. Direciona o WPP para ignorar os pontos de exclamação, também conhecidos como "gritos", usados em formatações complexas, como %carimbo de data/hora!%.

 %(TraceWpp.WppIgnoreExclamationmarks) -noshrieks
KernelMode

Parâmetro booleano opcional. Define a macro WPP_KERNEL_MODE, que rastreia componentes de modo kernel. Por padrão, apenas 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 opcional string[]. Define um símbolo de pré-processamento para o arquivo de origem.

 %(TraceWpp.WppPreprocessorDefinitions) /D
PreserveExtensions

Parâmetro opcional string[]. 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. Procura 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 a cadeia de caracteres especificada para iniciar o rastreamento.

 %(TraceWpp.WppSearchString) -lookfor:String
ToolPath

Parâmetro de cadeia de caracteres opcional. Permite especificar o caminho completo para a pasta onde a ferramenta está localizada.

 $(WPPToolPath)
TraceFunction

Parâmetro opcional string[]. 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 booleano opcional. Se verdadeiro, rastreia os padrões de acesso a arquivos para essa tarefa.

 $(TrackFileAccess)

WPP Preprocessor

Rastreamento de Software WPP

  • Last updated on