Tarea TraceWPP

El Kit de controladores de Windows (WDK) proporciona la tarea TraceWPP para que pueda ejecutar la herramienta de 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 permite el seguimiento de los archivos de origen. La tarea wpp se ejecuta a través de todas las colecciones de elementos clCompile e invoca tracewpp.exe para cada elemento para el que los metadatos de WppEnabled se establecen en 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.

Nota Puede acceder a los metadatos de item para tracewpp mediante el elemento ClCompile en los archivos del proyecto. 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

En el ejemplo anterior se muestra que MSBuild invoca tracewpp.exe solo en b.c y test2.c porque los metadatos de WppEnabled se establecen en TRUE para estas entradas. 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	Metadatos de elementos	Conmutador de herramienta
Sources Se requiere el parámetro ITaskItem[]. 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. Si el valor es TRUE, WPP realiza una compilación incremental de seguimiento. 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. Una lista de opciones de la 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 a omitir las signos de exclamación, también conocidos como "eshrieks", 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 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 tlogs.	%(TraceWpp.WppTrackerLogDirectory)
TrackFileAccess Parámetro booleano opcional. Si es true, realiza un seguimiento de los patrones de acceso a archivos para esta tarea.	$(TrackFileAccess)

Temas relacionados

Preprocesador de WPP

Seguimiento de software de WPP