Nivel de seguimiento

Los niveles de seguimiento son propiedades de un proveedor de seguimiento, como un controlador en modo kernel o una aplicación en modo de usuario. Los niveles de seguimiento determinan qué eventos genera el proveedor de seguimiento. Normalmente, el nivel de seguimiento representa la gravedad del evento (información, advertencia o error), pero los proveedores de seguimiento pueden definirlos para representar cualquier condición para generar el mensaje de seguimiento.

A diferencia de las marcas de seguimiento, que son definidas por el proveedor de seguimiento en la estructura WPP_CONTROL_GUIDS, los niveles de seguimiento se definen en Evntrace.h, un archivo de cabecera pública. Sin embargo, el proveedor de seguimiento interpreta el nivel y determina su efecto.

Los consumidores de trazas, como Tracelog y TraceView, pasan un nivel de traza al proveedor en el parámetro EnableLevel de la función EnableTrace. Para obtener información sobre EnableTrace, consulte la documentación del SDK de Microsoft Windows.

Los desarrolladores de proveedores de seguimiento también pueden escribir funciones de seguimiento personalizadas (alternativas a DoTraceMessage) que incluyen el nivel de seguimiento como condición para generar el mensaje de seguimiento. Para obtener instrucciones, consulte ¿Puedo personalizar DoTraceMessage?

Al ejecutar una sesión de seguimiento, los usuarios pueden usar el nivel de seguimiento para determinar qué mensajes se generarán durante la sesión. Los consumidores de seguimiento, como Tracelog y TraceView, permiten a los usuarios establecer parámetros y opciones para seleccionar las marcas de seguimiento y el nivel de seguimiento de cada proveedor en una sesión de seguimiento.

Al igual que las marcas de seguimiento, los usuarios pueden cambiar el nivel de seguimiento mientras se ejecuta una sesión de seguimiento al volver a habilitar el proveedor de seguimiento.