TraceLoggingEventTag 매크로(traceloggingprovider.h)

이벤트에 대한 이벤트 태그를 설정하는 TraceLogging 래퍼 매크로입니다.

구문

void TraceLoggingEventTag(
  [in]  eventTag
);

매개 변수

[in] eventTag

이벤트 태그 값을 지정하는 컴파일 시간 상수입니다.

C++에서는 0부터 0x0FFFFFFF 범위의 모든 값이 될 수 있습니다.

C에서 이 값은 0부터 0x0FFFA000 범위의 모든 값일 수 있으며 낮은 14비트 는 0으로 설정됩니다.

반환 값

없음

설명

TraceLoggingEventTag(eventTag) 는 TraceLoggingWrite 매크로 호출에 대한 매개 변수로 사용하여 이벤트의 태그를 설정할 수 있습니다.

태그의 의미 체계는 이벤트 소비자에 의해 정의됩니다. 이벤트 처리 중에 태그 값은 TRACE_EVENT_INFO 태그 필드에서 검색할 수 있습니다.

TraceLogging 스키마 규칙은 최대 4바이트의 체인을 사용하여 태그를 28비트 필드로 인코딩하고 가장 큰 비트가 'chain' 비트로 사용됩니다(4바이트 * 바이트당 7개의 사용 가능한 비트 = 28비트). 데이터는 가장 중요한 바이트를 먼저 인코딩합니다. C에서 TraceLoggingWrite 는 태그에 대한 2 바이트 인코딩으로 제한되므로 태그의 하위 14비트는 0이어야 합니다.

이벤트에 대해 TraceLoggingEventTag 매개 변수가 제공되지 않으면 이벤트에 대한 태그가 전송되지 않으며 이벤트에는 0의 태그가 있습니다. 여러 TraceLoggingEventTag 매개 변수가 제공된 경우 태그 값은 함께 OR입니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	traceloggingprovider.h

추가 정보

TraceLoggingWrite

추적 로깅 래퍼 매크로

TRACE_EVENT_INFO