次の方法で共有


TraceLoggingLevel マクロ (traceloggingprovider.h)

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

構文

void TraceLoggingLevel(
  [in]  eventLevel
);

パラメーター

[in] eventLevel

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

重要

ProviderId、Level、Keyword は、イベントをフィルター処理するための主要な手段です。 他の種類のフィルター処理も可能ですが、オーバーヘッドははるかに高くなります。 常に意味のあるゼロ以外のレベルを割り当て、すべてのイベントにキーワード (keyword)します。

イベント レベルの詳細については、「 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 は、イベント プロバイダーによって定義できます。

セマンティクス
LOG_ALWAYS (0) イベントは、レベルベースのイベント フィルター処理をバイパスします。 イベントでは、このレベルを使用しないでください。
CRITICAL (1) 重大なエラー
ERROR (2) エラー
警告 (3) 警告
INFO (4) Informational
VERBOSE (5) "詳細"

イベント コレクション セッションではレベル フィルターを設定できます。つまり、セッションは、 の 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"));

要件

要件
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ | UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリ | UWP アプリ]
対象プラットフォーム Windows
ヘッダー traceloggingprovider.h

こちらもご覧ください

EVENT_DESCRIPTOR

TraceLoggingWrite

TraceLogging ラッパー マクロ