다음을 통해 공유

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_EVENT_KEY
 DataPtr 멤버는 64비트 스칼라인 고유한 이벤트 식별자를 포함하는 EVENT_EXTENDED_ITEM_EVENT_KEY 구조를 가리킵니다.

지정된 공급자가 이 기능을 사용하도록 설정하려면 EnableTrace 호출에 EnableProperty EVENT_ENABLE_PROPERTY_EVENT_KEY 전달해야 합니다.
EVENT_HEADER_EXT_TYPE_EVENT_SCHEMA_TL
 DataPtr 멤버는 TraceLogging 이벤트 메타데이터 정보를 포함하는 확장 헤더 항목을 가리킵니다.
EVENT_HEADER_EXT_TYPE_INSTANCE_INFO
 DataPtr 멤버는 TraceEventInstance 호출하여 이벤트를 작성하는 경우 활동 식별자가 포함된 EVENT_EXTENDED_ITEM_INSTANCE 구조를 가리킵니다.
EVENT_HEADER_EXT_TYPE_PMC_COUNTERS
 DataPtr 멤버는 현재 PMC 카운터 값이 포함된 EVENT_EXTENDED_ITEM_PMC_COUNTERS 구조를 가리킵니다. 이 기능을 사용하려면 TraceProfileSourceListInfo사용하여 TraceQueryInformation 호출하여 유효한 원본 값을 찾은 TraceSetInformation통해 CPU에 대한 유효한 PMC 카운터를 설정해야 합니다.
EVENT_HEADER_EXT_TYPE_PROCESS_START_KEY
 DataPtr 멤버는 고유한 프로세스 식별자(부팅 세션에서 고유)가 포함된 EVENT_EXTENDED_ITEM_PROCESS_START_KEY 구조를 가리킵니다. 이 식별자는 64비트 스칼라입니다.

지정된 공급자가 이 기능을 사용하도록 설정하려면 EnableTrace 호출에 EnableProperty EVENT_ENABLE_PROPERTY_PROCESS_START_KEY 전달해야 합니다.
EVENT_HEADER_EXT_TYPE_PROV_TRAITS
 DataPtr 멤버는 공급자 특성 데이터가 포함된 확장 헤더 항목을 가리킵니다(예: EventSetInformation(EventProviderSetTraits) 통해 설정되거나 EVENT_DATA_DESCRIPTOR_TYPE_PROVIDER_METADATA통해 지정된 특성).
EVENT_HEADER_EXT_TYPE_RELATED_ACTIVITYID
 DataPtr 멤버는 EventWriteTransfer 호출하여 이벤트를 작성하는 경우 관련 활동 식별자가 포함된 EVENT_EXTENDED_ITEM_RELATED_ACTIVITYID 구조를 가리킵니다.
EVENT_HEADER_EXT_TYPE_SID
 DataPtr 멤버는 이벤트를 기록한 사용자의 SID(보안 식별자)가 포함된 SID 구조를 가리킵니다. EnableTraceExEnableProperty 매개 변수를 EVENT_ENABLE_PROPERTY_SID 설정하면 ETW에 SID가 포함됩니다.
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_TS_ID
 DataPtr 멤버는 터미널 세션 식별자를 포함하는 EVENT_EXTENDED_ITEM_TS_ID 구조를 가리킵니다. EnableTraceExEnableProperty 매개 변수를 EVENT_ENABLE_PROPERTY_TS_ID 설정하면 ETW에 터미널 세션 식별자가 포함됩니다.

Linkage

예약.

Reserved2

예약.

DataSize

DataPtr를 가리키는 확장 데이터의 크기(바이트)입니다.

DataPtr

확장 데이터에 대한 포인터입니다. ExtType 멤버는 이 멤버가 가리키는 확장 데이터의 형식을 결정합니다.

요구 사항

요구 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
헤더 evntcons.h(Evntcons.h 포함)

참고 항목

EVENT_RECORD