TraceLoggingLevel マクロ (traceloggingprovider.h)

イベントのレベルを設定する TraceLogging ラッパー マクロ。

構文

void TraceLoggingLevel(
  [in]  eventLevel
);

パラメーター

[in] eventLevel

イベントの重大度または重要度を表すために使用される 8 ビットの数値。 この値は、0 ~ 255 の範囲のコンパイル時定数である必要があります。 TraceLoggingWrite 呼び出しに TraceLoggingLevel 引数が指定されていない場合、イベントのレベルは既定で 5 (WINEVENT_LEVEL_VERBOSE) になります。

イベント レベルの詳細については、「 EVENT_DESCRIPTOR 」を参照してください。

戻り値

なし

解説

TraceLoggingLevel(eventLevel) を TraceLoggingWrite マクロの呼び出しのパラメーターとして使用して、イベントのレベルを設定できます。 イベント レベルは、イベントをフィルター処理するための主な手段です。 常にすべてのイベントに意味のある (0 以外の) レベルを割り当てます。

TraceLoggingWrite 呼び出しに TraceLoggingLevel マクロが指定されていない場合、イベントの既定のレベルは 5 (WINEVENT_LEVEL_VERBOSE) です。 複数の TraceLoggingLevel マクロが指定されている場合は、最後の値が使用されます。

レベル値 0 ~ 5 は、Microsoft によって定義されます (および winmeta.hを参照)。evntrace.h レベル値 6 から 15 は、Microsoft によって将来の定義用に予約されています。 レベル値 16 から 255 は、イベント プロバイダーによって定義できます。

イベント コレクション セッションではレベル フィルターを設定できます。つまり、セッションは、 の eventDescriptor.Level <= session.LevelFilterイベントのみを受け入れます。 レベルが 0 のイベントは、レベルベースのフィルター処理をバイパスすることに注意してください。

例

TraceLoggingWrite(
    g_hMyProvider,
    "MyWarningEventName",
    TraceLoggingLevel(WINEVENT_LEVEL_WARNING), // Levels defined in <winmeta.h>
    TraceLoggingKeyword(MyNetworkingKeyword), // Provider-defined keyword
    TraceLoggingHResult(errorCode, "Error"));

要件

こちらもご覧ください

EVENT_DESCRIPTOR

TraceLoggingWrite

TraceLogging ラッパー マクロ