header traceloggingprovider.h

TraceLogging adalah sistem untuk mencatat peristiwa yang menjelaskan sendiri peristiwa yang dapat didekodekan tanpa manifes. Di Windows, TraceLogging digunakan untuk menghasilkan peristiwa Pelacakan Peristiwa untuk Windows (ETW ).

Header TraceLoggingProvider.h di Windows SDK memiliki makro dan fungsi sebaris untuk menghasilkan peristiwa ETW yang dikodekan TraceLogging untuk kode kernel dan mode pengguna menggunakan C atau C++.

Mulai Cepat

• Dalam file .c atau .cpp, gunakan makro TRACELOGGING_DEFINE_PROVIDER untuk mendeklarasikan handel penyedia global. Handel penyedia mewakili koneksi komponen Anda ke ETW.
• Pada startup komponen (misalnya di main, , wmain, DllMainatau DriverEntry), gunakan fungsi TraceLoggingRegister untuk membuka koneksi komponen Anda ke ETW.
• Pada penonaktifan komponen, gunakan fungsi TraceLoggingUnregister untuk menutup koneksi komponen Anda ke ETW.
• Selama eksekusi komponen, gunakan makro TraceLoggingWrite untuk menghasilkan peristiwa ETW yang dikodekan TraceLogging.
• Jika diperlukan, gunakan makro TRACELOGGING_DECLARE_PROVIDER di header untuk mendeklarasikan handel penyedia agar dapat digunakan di bagian lain komponen Anda.
• Gunakan alat seperti WPR, tracelog, atau traceview untuk mengumpulkan jejak.
• Gunakan alat seperti WPA, tracefmt, atau traceview untuk mendekode dan melihat jejak.

Contoh

#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;
}

Untuk informasi selengkapnya, lihat:

• TraceLogging
• Makro pembungkus TraceLogging
• TraceLoggingWrite
• TRACELOGGING_DECLARE_PROVIDER
• TRACELOGGING_DEFINE_PROVIDER

traceloggingprovider.h berisi antarmuka pemrograman berikut:

Fungsi