encabezado traceloggingprovider.h

TraceLogging es un sistema para registrar eventos autodescriptos que se pueden descodificar sin un manifiesto. En Windows, el registro de seguimiento se usa para generar eventos de seguimiento de eventos para Windows (ETW).

El encabezado TraceLoggingProvider.h de Windows SDK tiene macros y funciones insertadas para generar eventos ETW codificados en TraceLogging para el código kernel y en modo de usuario mediante C o C++.

Inicio rápido

• En un archivo .c o .cpp, use la macro TRACELOGGING_DEFINE_PROVIDER para declarar un identificador de proveedor global. El identificador del proveedor representa la conexión del componente a ETW.
• Al iniciar el componente (por ejemplo, en main, wmainDllMain, o DriverEntry), use la función TraceLoggingRegister para abrir la conexión del componente a ETW.
• Al apagar el componente, use la función TraceLoggingUnregister para cerrar la conexión del componente a ETW.
• Durante la ejecución del componente, use la macro TraceLoggingWrite para generar eventos ETW codificados en TraceLogging.
• Según sea necesario, use la macro TRACELOGGING_DECLARE_PROVIDER en encabezados para reenviar el identificador del proveedor para que se pueda usar en otras partes del componente.
• Use herramientas como WPR, tracelog o traceview para recopilar seguimientos.
• Usa herramientas como WPA, tracefmt o traceview para descodificar y ver seguimientos.

Ejemplo

#include <windows.h> // or <wdm.h> for kernel-mode.
#include <winmeta.h> // For event level definitions.
#include <TraceLoggingProvider.h>

TRACELOGGING_DEFINE_PROVIDER( // defines g_hProvider
    g_hProvider, // Name of the provider handle
    "MyCompany.MyComponent", // Human-readable name for the provider
    // {ce5fa4ea-ab00-5402-8b76-9f76ac858fb5}
    (0xce5fa4ea,0xab00,0x5402,0x8b,0x76,0x9f,0x76,0xac,0x85,0x8f,0xb5));

int main(int argc, char* argv[]) // or DriverEntry for kernel-mode.
{
    TraceLoggingRegister(g_hProvider);

    TraceLoggingWrite(
        g_hProvider,
        "MyEvent1",
        TraceLoggingLevel(WINEVENT_LEVEL_WARNING), // Levels defined in <winmeta.h>
        TraceLoggingKeyword(MyEventCategories), // Provider-defined categories
        TraceLoggingString(argv[0], "arg0"), // field name is "arg0"
        TraceLoggingInt32(argc)); // field name is implicitly "argc"

    TraceLoggingUnregister(g_hProvider);
    return 0;
}

Para más información, consulte:

• TraceLogging
• Macros contenedoras traceLogging
• TraceLoggingWrite
• TRACELOGGING_DECLARE_PROVIDER
• TRACELOGGING_DEFINE_PROVIDER

traceloggingprovider.h contiene las siguientes interfaces de programación:

Functions