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 |