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

추가 정보

EVENT_DESCRIPTOR

TraceLoggingWrite

TraceLogging 래퍼 매크로