TraceLoggingOpcode 매크로(traceloggingprovider.h)

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

구문

void TraceLoggingOpcode(
  [in]  eventOpcode
);

매개 변수

[in] eventOpcode

이벤트를 특수 의미 체계로 표시하는 데 사용되는 8비트 숫자입니다. 이 값은 0에서 255 범위의 컴파일 시간 상수여야 합니다.

opcode는 추적 디코더가 이벤트를 구성하고 상호 연결하는 데 사용됩니다. 전역적으로 인식되는 opcode 값은 에 정의되어 있습니다 winmeta.h. 대부분의 이벤트는 0(WINEVENT_OPCODE_INFO)을 사용하여 이벤트에 특별한 의미 체계가 없음을 나타냅니다. Opcode 값 10~239는 사용자 정의 의미 체계를 지정할 수 있습니다.

이벤트 opcode에 대한 자세한 내용은 EVENT_DESCRIPTOR 참조하세요.

반환 값

없음

설명

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

TraceLoggingWrite 호출에 TraceLoggingOpcode 매크로가 제공되지 않으면 이벤트의 기본 opcode는 0(WINEVENT_OPCODE_INFO)입니다. 여러 TraceLoggingOpcode 매크로가 제공되면 마지막 값이 사용됩니다.

opcodes WINEVENT_OPCODE_START(1) 및 WINEVENT_OPCODE_STOP(2)는 다음과 같이 ETW 활동의 시작과 끝을 나타내는 데 사용됩니다.

1. 일반적으로 EventActivityIdControl 또는 UuidCreate를 사용하여 추적 내에서 고유한 활동 ID를 생성합니다.
2. opcode = START, 활동 ID = 생성된 활동 ID 및 관련 활동 ID = 부모 활동 ID(또는 부모 활동 ID가 없는 경우 NULL)를 사용하여 시작 이벤트를 작성합니다.
3. opcode = INFO, 활동 ID = 생성된 활동 ID를 사용하여 여러 활동 정보 이벤트를 작성합니다.
4. opcode = STOP, 활동 ID = 생성된 활동 ID를 사용하여 중지 이벤트를 작성합니다.

그런 다음 추적 디코딩 도구는 해당 활동 ID에 따라 이러한 이벤트를 그룹으로 구성할 수 있습니다.

요구 사항

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

추가 정보

EVENT_DESCRIPTOR

EventActivityIdControl

TraceLoggingWrite

추적 로깅 래퍼 매크로