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 활동의 시작과 끝을 나타내는 데 사용됩니다.
- 일반적으로 EventActivityIdControl 또는 UuidCreate를 사용하여 추적 내에서 고유한 활동 ID를 생성합니다.
- opcode = START, 활동 ID = 생성된 활동 ID 및 관련 활동 ID = 부모 활동 ID(또는 부모 활동 ID가 없는 경우 NULL)를 사용하여 시작 이벤트를 작성합니다.
- opcode = INFO, 활동 ID = 생성된 활동 ID를 사용하여 여러 활동 정보 이벤트를 작성합니다.
- opcode = STOP, 활동 ID = 생성된 활동 ID를 사용하여 중지 이벤트를 작성합니다.
그런 다음 추적 디코딩 도구는 해당 활동 ID에 따라 이러한 이벤트를 그룹으로 구성할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | traceloggingprovider.h |