Agregar macros de WPP a un proveedor de seguimiento
Para agregar la forma predeterminada de seguimiento de software de WPP a un proveedor de seguimiento, como un controlador en modo kernel o una aplicación en modo de usuario, agregue las siguientes directivas de preprocesador de C y llamadas de macros de WPP al código fuente del proveedor:
Una directiva #include del siguiente formulario para cada archivo de origen que contenga cualquier macro de WPP. Esta instrucción incluye el archivo de encabezado del mensaje de seguimiento creado por el preprocesador WPP para cada archivo de origen:
#include <source-file-name.tmh>El archivo de encabezado del mensaje de seguimiento debe incluirse en un archivo de origen antes de que cualquier macro de WPP llame a y después de definir una macro de WPP_CONTROL_GUIDS .
Una directiva de definición de WPP_CONTROL_GUIDS a cada archivo de origen que incluye otras macros de WPP.
Esta definición especifica el GUID de control del controlador y los nombres de marca de seguimiento definidos por el controlador. La definición debe agregarse a un archivo de origen antes de la instrucción #include que incluya el archivo de encabezado del mensaje de seguimiento del archivo.
Una WPP_INIT_TRACING llamada de macro al código fuente del controlador.
En el caso de los controladores, esta macro activa el seguimiento de software en el controlador. Esta macro se suele llamar durante la inicialización del controlador, por ejemplo, en una rutina DriverEntry .
En el caso de las aplicaciones en modo de usuario, llame a esta macro en un punto del código fuente donde no se hayan realizado intentos de seguimiento anteriormente.
Después de la inicialización, puede usar TraceView o Tracelog para iniciar una sesión de seguimiento de software y mostrar mensajes de seguimiento.
Una WPP_CLEANUP llamada de macro al código fuente del proveedor de seguimiento . Esta macro desactiva el seguimiento de software en el controlador.
En el caso de los controladores, esta llamada a macro se agrega normalmente a la rutina Unload del controlador.
En el caso de las aplicaciones en modo de usuario, llame a esta macro en un punto del código fuente después de que se hayan realizado los últimos intentos de seguimiento.
La macro DoTraceMessage llama a para registrar mensajes de seguimiento.