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

확장 데이터 형식입니다. 가능한 값은 다음과 같습니다.

값 의미
EVENT_HEADER_EXT_TYPE_RELATED_ACTIVITYID
 DataPtr 멤버는 EventWriteTransfer를 호출하여 이벤트를 작성하는 경우 관련 활동 식별자가 포함된 EVENT_EXTENDED_ITEM_RELATED_ACTIVITYID 구조를 가리킵니다.
EVENT_HEADER_EXT_TYPE_SID
 DataPtr 멤버는 이벤트를 기록한 사용자의 SID(보안 식별자)가 포함된 SID 구조를 가리킵니다. ENABLETraceEx의 EnableProperty 매개 변수를 EVENT_ENABLE_PROPERTY_SID 설정하면 ETW에 SID가 포함됩니다.
EVENT_HEADER_EXT_TYPE_TS_ID
 DataPtr 멤버는 터미널 세션 식별자가 포함된 EVENT_EXTENDED_ITEM_TS_ID 구조를 가리킵니다. EnableTraceEx의 EnableProperty 매개 변수를 EVENT_ENABLE_PROPERTY_TS_ID 설정하면 ETW에 터미널 세션 식별자가 포함됩니다.
EVENT_HEADER_EXT_TYPE_INSTANCE_INFO
 DataPtr 멤버는 TraceEventInstance를 호출하여 이벤트를 작성하는 경우 활동 식별자가 포함된 EVENT_EXTENDED_ITEM_INSTANCE 구조를 가리킵니다.
EVENT_HEADER_EXT_TYPE_STACK_TRACE32
 DataPtr 멤버는 이벤트가 32비트 컴퓨터에서 캡처되는 경우 호출 스택이 포함된 EVENT_EXTENDED_ITEM_STACK_TRACE32 구조를 가리킵니다.
EVENT_HEADER_EXT_TYPE_STACK_TRACE64
 DataPtr 멤버는 이벤트가 64비트 컴퓨터에서 캡처되는 경우 호출 스택이 포함된 EVENT_EXTENDED_ITEM_STACK_TRACE64 구조를 가리킵니다.
EVENT_HEADER_EXT_TYPE_EVENT_SCHEMA_TL
 DataPtr 멤버는 TraceLogging 이벤트 메타데이터 정보가 포함된 확장 헤더 항목을 가리킵니다.
EVENT_HEADER_EXT_TYPE_PROV_TRAITS
 DataPtr 멤버는 공급자 특성 데이터가 포함된 확장 헤더 항목(예: EventSetInformation(EventProviderSetTraits)을 통해 설정되거나 EVENT_DATA_DESCRIPTOR_TYPE_PROVIDER_METADATA 통해 지정된 특성을 가리킵니다.
EVENT_HEADER_EXT_TYPE_EVENT_KEY
 DataPtr 멤버는 64비트 스칼라인 고유한 이벤트 식별자를 포함하는 EVENT_EXTENDED_ITEM_EVENT_KEY 구조를 가리킵니다.

이 기능을 사용하도록 설정하려면 지정된 공급자에 대한 EnableTrace 호출에 대해 EnableProperty EVENT_ENABLE_PROPERTY_EVENT_KEY 전달해야 합니다.
EVENT_HEADER_EXT_TYPE_PROCESS_START_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 포함)

추가 정보

EVENT_RECORD