TraceLoggingKeyword 매크로(traceloggingprovider.h)

이벤트에 대한 키워드(keyword) 설정하는 TraceLogging 래퍼 매크로입니다.

구문

void TraceLoggingKeyword(
  [in]  eventKeyword
);

매개 변수

[in] eventKeyword

이벤트 범주 집합에서 이벤트의 멤버 자격을 나타내는 데 사용되는 64비트 비트 마스크입니다. 이 값은 컴파일 시간 상수여야 합니다.

중요

ProviderId, Level 및 Keyword는 이벤트를 필터링하는 기본 수단입니다. 다른 종류의 필터링이 가능하지만 오버헤드가 훨씬 더 높습니다. 항상 의미 있는 0이 아닌 수준을 할당하고 모든 이벤트에 키워드(keyword).

이벤트 키워드(keyword) 대한 자세한 내용은 EVENT_DESCRIPTOR 참조하세요.

반환 값

없음

설명

TraceLoggingKeyword(eventKeyword)는 TraceLoggingWrite 매크로를 호출하는 매개 변수로 사용하여 이벤트의 키워드(keyword) 설정할 수 있습니다. 이벤트 키워드(keyword) 이벤트를 필터링하는 기본 수단입니다. 항상 모든 이벤트에 의미 있는(0이 아닌) 키워드(keyword) 할당합니다.

TraceLoggingWrite 호출에 TraceLoggingKeyword 매크로가 제공되지 않으면 이벤트의 기본 키워드(keyword) 0입니다. 여러 TraceLoggingKeyword 매크로가 제공되면 값은 함께 OR입니다.

키워드(keyword) 상위 16비트(비트 마스크 0xFFFF000000000000)는 Microsoft에서 정의합니다. 키워드(keyword) 하위 48비트(비트 마스크 0x0000FFFFFFFFFFFF)는 이벤트 공급자에 의해 정의됩니다. 예를 들어 이벤트 공급자는 비트 0(비트 마스크 0x1)을 "I/O" 범주로 정의하고 비트 1(비트 마스크 0x2)을 "UI" 범주로 정의하고 비트 2(비트 마스크 0x4)를 "성능 측정" 범주로 정의할 수 있습니다. 이 시나리오에서 이벤트는 해당 키워드(keyword) 0x5 설정하여 이벤트가 "I/O" 및 "성능 측정" 범주 모두에 있음을 나타낼 수 있습니다.

요구 사항

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

추가 정보

EVENT_DESCRIPTOR

TraceLoggingWrite

TraceLogging 래퍼 매크로