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

структура 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_RELATED_ACTIVITYID
 Элемент DataPtr указывает на структуру EVENT_EXTENDED_ITEM_RELATED_ACTIVITYID , содержащую идентификатор связанного действия, если для записи события был вызван метод EventWriteTransfer .
EVENT_HEADER_EXT_TYPE_SID
 Элемент DataPtr указывает на структуру sid , содержащую идентификатор безопасности (SID) пользователя, который зарегистрировал событие. EtW включает идентификатор безопасности, если для параметра EnablePropertyEnableTraceEx задано значение EVENT_ENABLE_PROPERTY_SID.
EVENT_HEADER_EXT_TYPE_TS_ID
 Элемент DataPtr указывает на структуру EVENT_EXTENDED_ITEM_TS_ID , содержащую идентификатор сеанса терминала. EtW включает идентификатор сеанса терминала, если для параметра EnablePropertyEnableTraceEx задано значение EVENT_ENABLE_PROPERTY_TS_ID.
EVENT_HEADER_EXT_TYPE_INSTANCE_INFO
 Элемент DataPtr указывает на EVENT_EXTENDED_ITEM_INSTANCE структуру, содержащую идентификатор действия, если вы вызвали TraceEventInstance для записи события.
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_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 указывает на структуру EVENT_EXTENDED_ITEM_EVENT_KEY, содержащую уникальный идентификатор события, представляющий собой 64-разрядный скаляр.

Чтобы включить эту функцию, необходимо передать EVENT_ENABLE_PROPERTY_EVENT_KEY EnableProperty для вызова EnableTrace для данного поставщика.
EVENT_HEADER_EXT_TYPE_PROCESS_START_KEY
 Элемент DataPtr указывает на структуру EVENT_EXTENDED_ITEM_PROCESS_START_KEY, содержащую уникальный идентификатор процесса (уникальный в рамках сеанса загрузки). Этот идентификатор является 64-разрядным скалярным.

Чтобы включить эту функцию, необходимо передать EVENT_ENABLE_PROPERTY_PROCESS_START_KEY EnableProperty для вызова EnableTrace для данного поставщика.

Linkage

Зарезервировано.

Reserved2

Зарезервировано.

DataSize

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

DataPtr

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

Требования

   
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Верхняя часть evntcons.h (включая Evntcons.h)

См. также раздел

EVENT_RECORD