EVENT_HEADER_EXTENDED_DATA_ITEM 구조체(evntcons.h)
ETW(Windows용 이벤트 추적)가 이벤트 데이터의 일부로 수집하는 확장 데이터를 정의합니다.
구문
typedef struct _EVENT_HEADER_EXTENDED_DATA_ITEM {
USHORT Reserved1;
USHORT ExtType;
struct {
USHORT Linkage : 1;
USHORT Reserved2 : 15;
};
USHORT DataSize;
ULONGLONG DataPtr;
} EVENT_HEADER_EXTENDED_DATA_ITEM, *PEVENT_HEADER_EXTENDED_DATA_ITEM;
멤버
Reserved1
예약되어 있습니다.
ExtType
확장 데이터 형식입니다. 가능한 값은 다음과 같습니다.
| 값 | 의미 |
|---|---|
|
DataPtr 멤버는 EventWriteTransfer를 호출하여 이벤트를 작성하는 경우 관련 활동 식별자가 포함된 EVENT_EXTENDED_ITEM_RELATED_ACTIVITYID 구조를 가리킵니다. |
|
DataPtr 멤버는 이벤트를 기록한 사용자의 SID(보안 식별자)가 포함된 SID 구조를 가리킵니다. ENABLETraceEx의 EnableProperty 매개 변수를 EVENT_ENABLE_PROPERTY_SID 설정하면 ETW에 SID가 포함됩니다. |
|
DataPtr 멤버는 터미널 세션 식별자가 포함된 EVENT_EXTENDED_ITEM_TS_ID 구조를 가리킵니다. EnableTraceEx의 EnableProperty 매개 변수를 EVENT_ENABLE_PROPERTY_TS_ID 설정하면 ETW에 터미널 세션 식별자가 포함됩니다. |
|
DataPtr 멤버는 TraceEventInstance를 호출하여 이벤트를 작성하는 경우 활동 식별자가 포함된 EVENT_EXTENDED_ITEM_INSTANCE 구조를 가리킵니다. |
|
DataPtr 멤버는 이벤트가 32비트 컴퓨터에서 캡처되는 경우 호출 스택이 포함된 EVENT_EXTENDED_ITEM_STACK_TRACE32 구조를 가리킵니다. |
|
DataPtr 멤버는 이벤트가 64비트 컴퓨터에서 캡처되는 경우 호출 스택이 포함된 EVENT_EXTENDED_ITEM_STACK_TRACE64 구조를 가리킵니다. |
|
DataPtr 멤버는 TraceLogging 이벤트 메타데이터 정보가 포함된 확장 헤더 항목을 가리킵니다. |
|
DataPtr 멤버는 공급자 특성 데이터가 포함된 확장 헤더 항목(예: EventSetInformation(EventProviderSetTraits)을 통해 설정되거나 EVENT_DATA_DESCRIPTOR_TYPE_PROVIDER_METADATA 통해 지정된 특성을 가리킵니다. |
|
DataPtr 멤버는 64비트 스칼라인 고유한 이벤트 식별자를 포함하는 EVENT_EXTENDED_ITEM_EVENT_KEY 구조를 가리킵니다.
이 기능을 사용하도록 설정하려면 지정된 공급자에 대한 EnableTrace 호출에 대해 EnableProperty EVENT_ENABLE_PROPERTY_EVENT_KEY 전달해야 합니다. |
|
DataPtr 멤버는 고유한 프로세스 식별자(부팅 세션에서 고유)가 포함된 EVENT_EXTENDED_ITEM_PROCESS_START_KEY 구조를 가리킵니다. 이 식별자는 64비트 스칼라입니다.
이 기능을 사용하도록 설정하려면 지정된 공급자에 대한 EnableTrace 호출에 대해EnableProperty EVENT_ENABLE_PROPERTY_PROCESS_START_KEY 전달해야 합니다. |
Linkage
예약되어 있습니다.
Reserved2
예약되어 있습니다.
DataSize
DataPtr에서 가리키는 확장 데이터의 크기(바이트)입니다.
DataPtr
확장된 데이터에 대한 포인터입니다. ExtType 멤버는 이 멤버가 가리키는 확장 데이터 형식을 결정합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 머리글 | evntcons.h(Evntcons.h 포함) |