TraceLoggingLevel 매크로(traceloggingprovider.h)
이벤트의 수준을 설정하는 TraceLogging 래퍼 매크로입니다.
구문
void TraceLoggingLevel(
[in] eventLevel
);
매개 변수
[in] eventLevel
이벤트의 심각도 또는 중요도를 설명하는 데 사용되는 8비트 숫자입니다. 이 값은 0에서 255 범위의 컴파일 시간 상수여야 합니다. TraceLoggingWrite 호출에 TraceLoggingLevel 인수가 제공되지 않으면 이벤트의 수준은 기본적으로 5(WINEVENT_LEVEL_VERBOSE)로 설정됩니다.
중요
ProviderId, Level 및 Keyword는 이벤트를 필터링하는 기본 수단입니다. 다른 종류의 필터링이 가능하지만 오버헤드가 훨씬 더 높습니다. 항상 의미 있는 0이 아닌 수준을 할당하고 모든 이벤트에 키워드(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) | 오류 |
| 오류 (2) | 오류 |
| 경고 (3) | 경고 |
| 정보 (4) | 정보 제공 |
| 자세한 정보 표시 (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 |