Compartir a través de

TraceWPP task

El Kit de controladores de Windows (WDK) proporciona la tarea TraceWPP para que pueda ejecutar la herramienta tracewpp.exe al compilar el controlador mediante MSBuild. La herramienta tracewpp.exe se usa para implementar el seguimiento de software de WPP.

WppEnabled es un nuevo metadato para el elemento ClCompile que habilita el seguimiento de los archivos de origen. 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.

Los metadatos de WppEnabled se agregaron al elemento ClCompile porque la tarea WPP se ejecuta en el mismo tipo de archivos de entrada que la tarea CL, en este caso .c, .cpp y archivos .h.

Note You access the Item metadata for tracewpp by using the ClCompile item in project files. MSBuild usa el elemento TraceWpp internamente dentro del destino para pasarlo a la tarea.

En el ejemplo siguiente se muestra cómo editar los metadatos en el archivo .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>

La invocación de la línea de comandos sería:

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. Tenga en cuenta también que los metadatos de estas dos entradas son diferentes. Por lo tanto, los modificadores también serán diferentes para estas entradas. En otras palabras, puede llamar a cada entrada con su propio conjunto de metadatos.

Parámetro de tarea WPP Item Metadata Tool Switch
Sources

Parámetro ITaskItem[] requerido. Especifica una lista de archivos de origen.

 @(TraceWpp)
AddAlternateNameToMessageGUID

Parámetro de cadena opcional. Especifica un nombre descriptivo alternativo para el GUID del mensaje para los mensajes que proceden de este proveedor de seguimiento.

 %(TraceWpp.WppAddAlternateNameToMessageGUID) -o:String
AdditionalConfigurationFile

Parámetro de cadena opcional. Especifica un archivo de configuración adicional. WPP usa el archivo especificado además del archivo predeterminado, defaultwpp.ini.

 %(TraceWpp.WppAdditionalConfigurationFile) -ini:Path
AdditionalIncludeDirectories

Parámetro string[] opcional. Agrega un directorio a la lista de directorios que WPP busca archivos de inclusión.

 %(TraceWpp.WppAdditionalIncludeDirectories) -I
AlternateConfigurationFile

Parámetro de cadena opcional. Especifica un archivo de configuración alternativo. WPP usa este archivo en lugar del archivo defaultwpp.ini.

 %(TraceWpp.WppAlternateConfigurationFile) -defwpp:Path
GenerateUsingTemplateFile

Parámetro de cadena opcional. Para cada archivo de origen que WPP procesa con el nombre especificado entre las llaves {}, WPP crea otro archivo con la extensión de nombre de archivo especificada.

 %(TraceWpp.WppGenerateUsingTemplateFile) -gen{File.tpl}*.ext
MinimalRebuildFromTracking

Parámetro booleano opcional. If the value is TRUE, WPP performs a tracked incremental build. De lo contrario, WPP realiza una recompilación.

 %(TraceWpp.WppMinimalRebuildFromTracking)
NumericBaseForFormatStrings

Parámetro int opcional. Establece una base numérica para la numeración de cadenas de formato.

 %(TraceWpp.WppNumericBaseForFormatStrings) -argbase:Number
AddControlGUID

Parámetro de cadena opcional. Define una macro de WPP_CONTROL_GUIDS con el GUID de control especificado y WPP_DEFINE_BIT entradas denominadas "Error", "Inusual" y "Ruido".

 %(TraceWpp.WppAddControlGUID) -ctl:GUID
AdditionalOptions

Parámetro de cadena opcional. Lista de opciones de línea de comandos.

 %(TraceWpp.WppAdditionalOptions)
ConfigurationDirectories

Parámetro string[] opcional. Especifica la ubicación de los archivos de configuración y plantilla.

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

Parámetro booleano opcional. Define la macro WPP_DLL.

 %(TraceWpp.WppDllMacro) -dll
FileExtensions

Parámetro string[] opcional. Especifica los tipos de archivo que WPP reconoce como archivos de origen. WPP omite los archivos con una extensión de nombre de archivo diferente.

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

Parámetro booleano opcional. Dirige a WPP para omitir las signos de exclamación, también conocidos como 'shrieks', que se usan en formato complejo, como %!timestamp!%.

 %(TraceWpp.WppIgnoreExclamationmarks) -noshrieks
KernelMode

Parámetro booleano opcional. Define la macro WPP_KERNEL_MODE, que realiza un seguimiento de los componentes del modo kernel. De forma predeterminada, solo se realiza un seguimiento de los componentes en modo de usuario.

 %(TraceWpp.WppKernelMode) -km
OutputDirectory

Parámetro de cadena opcional. Especifica el directorio de los archivos de salida que crea WPP.

 %(TraceWpp.WppOutputDirectory) -odir:Path
PreprocessorDefinitions

Parámetro string[] opcional. Define un símbolo de preprocesamiento para el archivo de origen.

 %(TraceWpp.WppPreprocessorDefinitions) /D
PreserveExtensions

Parámetro string[] opcional. Conserva las extensiones de nombre de archivo especificadas al crear archivos TMH.

 %(TraceWpp.WppPreserveExtensions) -preserveext:ext1[,ext2]
ScanConfigurationData

Parámetro de cadena opcional. Busca datos de configuración, como tipos de datos personalizados, en un archivo que no es un archivo de configuración, así como en defaultwpp.ini.

 %(TraceWpp.WppScanConfigurationData) -scan:File
SearchString

Parámetro de cadena opcional. Dirige a WPP a buscar los archivos de origen de la cadena especificada para iniciar el seguimiento.

 %(TraceWpp.WppSearchString) -lookfor:String
ToolPath

Parámetro de cadena opcional. Permite especificar la ruta de acceso completa a la carpeta donde se encuentra la herramienta.

 $(WPPToolPath)
TraceFunction

Parámetro string[] opcional. Especifica las funciones que se pueden usar para generar mensajes de seguimiento.

 %(TraceWpp.WppTraceFunction) -func:FunctionDescription
TrackerLogDirectory

Parámetro de cadena opcional. Directorio de registro para que el rastreador escriba registros de registro.

 %(TraceWpp.WppTrackerLogDirectory)
TrackFileAccess

Parámetro booleano opcional. Si es true, realiza un seguimiento de los patrones de acceso a archivos para esta tarea.

 $(TrackFileAccess)

WPP Preprocessor

Seguimiento de software de WPP

  • Last updated on