Поделиться через

структура EVENT_HEADER_EXTENDED_DATA_ITEM (evntcons.h)

  • Статья

Определяет расширенные данные, которые трассировка событий для Windows (ETW) собирается в рамках данных события.

Синтаксис

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 указывает на структуру EVENT_EXTENDED_ITEM_EVENT_KEY, содержащую уникальный идентификатор события, который является скалярным 64-разрядным.

Необходимо передать EnableProperty EVENT_ENABLE_PROPERTY_EVENT_KEY для вызова EnableTrace для данного поставщика, чтобы включить эту функцию.
EVENT_HEADER_EXT_TYPE_EVENT_SCHEMA_TL
 Элемент DataPtr указывает на расширенный элемент заголовка, содержащий сведения о метаданных события TraceLogging.
EVENT_HEADER_EXT_TYPE_INSTANCE_INFO
 Элемент DataPtr указывает на структуру EVENT_EXTENDED_ITEM_INSTANCE, содержащую идентификатор действия, если вы вызвали TraceEventInstance для записи события.
EVENT_HEADER_EXT_TYPE_PMC_COUNTERS
 Элемент DataPtr указывает на структуру EVENT_EXTENDED_ITEM_PMC_COUNTERS, содержащую текущие значения счетчика PMC. Чтобы включить эту функцию, допустимые счетчики PMC для ЦП должны быть заданы с помощью TraceSetInformationс допустимыми значениями Source, найденными путем вызова TraceQueryInformation с TraceProfileSourceListInfo.
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 указывает на структуруEVENT_EXTENDED_ITEM_RELATED_ACTIVITYID, содержащую связанный идентификатор действия, если вы вызвали EventWriteTransfer для записи события.
EVENT_HEADER_EXT_TYPE_SID
 Элемент DataPtr указывает на структуру SID, содержащую идентификатор безопасности пользователя, который зарегистрировал событие. EtW включает идентификатор безопасности, если для параметра enableProperty EnablePropertyEnableTraceEx значение EVENT_ENABLE_PROPERTY_SID.
EVENT_HEADER_EXT_TYPE_STACK_TRACE32
 Элемент DataPtr указывает на структуру EVENT_EXTENDED_ITEM_STACK_TRACE32, содержащую стек вызовов, если событие фиксируется на 32-разрядном компьютере.
EVENT_HEADER_EXT_TYPE_STACK_TRACE64
 Элемент DataPtr указывает на структуру EVENT_EXTENDED_ITEM_STACK_TRACE64, содержащую стек вызовов, если событие фиксируется на 64-разрядном компьютере.
EVENT_HEADER_EXT_TYPE_TS_ID
 Элемент DataPtr указывает на структуру EVENT_EXTENDED_ITEM_TS_ID, содержащую идентификатор сеанса терминала. EtW содержит идентификатор сеанса терминала, если параметр enableProperty EnableProperty параметра EnableTraceEx EVENT_ENABLE_PROPERTY_TS_ID.

Linkage

Скрытный.

Reserved2

Скрытный.

DataSize

Размер в байтах расширенных данных, на которые DataPtr указывает.

DataPtr

Указатель на расширенные данные. Элемент ExtType определяет тип расширенных данных, к которым указывает этот член.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows Vista [только классические приложения]
минимальный поддерживаемый сервер Windows Server 2008 [только классические приложения]
заголовка evntcons.h (include Evntcons.h)

См. также

EVENT_RECORD