traceloggingprovider.h ヘッダー

TraceLogging は、マニフェストなしでデコードできる自己記述型イベントをログに記録するためのシステムです。 Windows では、TraceLogging を使用して Windows イベント トレーシング (ETW) イベントを生成します。

Windows SDK の TraceLoggingProvider.h ヘッダーには、C または C++ を使用してカーネル およびユーザー モード コードの TraceLogging でエンコードされた ETW イベントを生成するためのマクロとインライン関数があります。

クイック スタート

• .c または .cpp ファイルで、 TRACELOGGING_DEFINE_PROVIDER マクロを使用してグローバル プロバイダー ハンドルを宣言します。 プロバイダー ハンドルは、ETW へのコンポーネントの接続を表します。
• コンポーネントの起動時 (、または DriverEntryなど) にはmainwmainDllMain、TraceLoggingRegister 関数を使用して、ETW へのコンポーネントの接続を開きます。
• コンポーネントのシャットダウン時に TraceLoggingUnregister 関数を使用して、ETW へのコンポーネントの接続を閉じます。
• コンポーネントの実行中に TraceLoggingWrite マクロを使用して、TraceLogging でエンコードされた ETW イベントを生成します。
• 必要に応じて、ヘッダーで TRACELOGGING_DECLARE_PROVIDER マクロを使用してプロバイダー ハンドルを前方宣言し、コンポーネントの他の部分で使用できるようにします。
• WPR、トレースログ、トレースビューなどのツールを使用してトレースを収集します。
• WPA、tracefmt、traceview などのツールを使用して、トレースをデコードして表示します。

例

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

詳細については、次を参照してください。

• TraceLogging
• TraceLogging ラッパー マクロ
• TraceLoggingWrite
• TRACELOGGING_DECLARE_PROVIDER
• TRACELOGGING_DEFINE_PROVIDER

traceloggingprovider.h には、次のプログラミング インターフェイスが含まれています。

関数