Compartilhar via

TraceWPP task

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 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, nesse caso arquivos .c, .cpp e .h.

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

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 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 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. O WPP usa o arquivo especificado além do arquivo padrão, defaultwpp.ini.

 %(TraceWpp.WppAdditionalConfigurationFile) -ini:Path
AdditionalIncludeDirectories

Parâmetro de cadeia de caracteres 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 booliano opcional. If the value is TRUE, WPP performs a tracked incremental build. 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 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 de cadeia de caracteres opcional[]. Especifica o local dos arquivos de configuração e de modelo.

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

Parâmetro booliano opcional. Define a macro WPP_DLL.

 %(TraceWpp.WppDllMacro) -dll
FileExtensions

Parâmetro de cadeia de caracteres 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 booliano opcional. Orienta o WPP a ignorar pontos de exclamação, também conhecidos como "gritos", usados na formatação complexa, como %!carimbo de data/hora!%.

 %(TraceWpp.WppIgnoreExclamationmarks) -noshrieks
KernelMode

Parâmetro booliano 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 de cadeia de caracteres opcional[]. Define um símbolo de pré-processamento para o arquivo de origem.

 %(TraceWpp.WppPreprocessorDefinitions) /D
PreserveExtensions

Parâmetro de cadeia de caracteres 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. Orienta o WPP a 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 de cadeia de caracteres 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 booliano opcional. Se for true, controla os padrões de acesso a arquivos para essa tarefa.

 $(TrackFileAccess)

WPP Preprocessor

Rastreamento de software WPP

  • Last updated on