estructura EVENT_HEADER_EXTENDED_DATA_ITEM (evntcons.h)

  • Artículo

Define los datos extendidos que recopila el seguimiento de eventos para Windows (ETW) como parte de los datos del evento.

Sintaxis

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;

Miembros

Reserved1

Reservado.

ExtType

Tipo de datos extendidos. A continuación se muestran los valores posibles.

Valor Significado
EVENT_HEADER_EXT_TYPE_RELATED_ACTIVITYID
 El miembro DataPtr apunta a una estructura de EVENT_EXTENDED_ITEM_RELATED_ACTIVITYID que contiene el identificador de actividad relacionado si llamó a EventWriteTransfer para escribir el evento.
EVENT_HEADER_EXT_TYPE_SID
 El miembro DataPtr apunta a una estructura SID que contiene el identificador de seguridad (SID) del usuario que registró el evento. ETW incluye el SID si establece el parámetro EnableProperty de EnableTraceEx en EVENT_ENABLE_PROPERTY_SID.
EVENT_HEADER_EXT_TYPE_TS_ID
 El miembro DataPtr apunta a una estructura de EVENT_EXTENDED_ITEM_TS_ID que contiene el identificador de sesión de terminal. ETW incluye el identificador de sesión de terminal si establece el parámetro EnableProperty de EnableTraceEx en EVENT_ENABLE_PROPERTY_TS_ID.
EVENT_HEADER_EXT_TYPE_INSTANCE_INFO
 El miembro DataPtr apunta a una estructura de EVENT_EXTENDED_ITEM_INSTANCE que contiene el identificador de actividad si llamó a TraceEventInstance para escribir el evento.
EVENT_HEADER_EXT_TYPE_STACK_TRACE32
 El miembro DataPtr apunta a una estructura de EVENT_EXTENDED_ITEM_STACK_TRACE32 que contiene la pila de llamadas si el evento se captura en un equipo de 32 bits.
EVENT_HEADER_EXT_TYPE_STACK_TRACE64
 El miembro DataPtr apunta a una estructura de EVENT_EXTENDED_ITEM_STACK_TRACE64 que contiene la pila de llamadas si el evento se captura en un equipo de 64 bits.
EVENT_HEADER_EXT_TYPE_EVENT_SCHEMA_TL
 El miembro DataPtr apunta a un elemento de encabezado extendido que contiene información de metadatos del evento TraceLogging.
EVENT_HEADER_EXT_TYPE_PROV_TRAITS
 El miembro DataPtr apunta a un elemento de encabezado extendido que contiene datos de rasgos del proveedor, por ejemplo rasgos establecidos a través de EventSetInformation(EventProviderSetTraits) o especificado a través de EVENT_DATA_DESCRIPTOR_TYPE_PROVIDER_METADATA.
EVENT_HEADER_EXT_TYPE_EVENT_KEY
 El miembro DataPtr apunta a una estructura de EVENT_EXTENDED_ITEM_EVENT_KEY que contiene un identificador de evento único que es un escalar de 64 bits.

El EVENT_ENABLE_PROPERTY_EVENT_KEY EnableProperty debe pasarse para la llamada enableTrace de un proveedor determinado para habilitar esta característica.
EVENT_HEADER_EXT_TYPE_PROCESS_START_KEY
 El miembro DataPtr apunta a una estructura de EVENT_EXTENDED_ITEM_PROCESS_START_KEY que contiene un identificador de proceso único (único en la sesión de arranque). Este identificador es un escalar de 64 bits.

La EVENT_ENABLE_PROPERTY_PROCESS_START_KEY EnableProperty debe pasarse para la llamada enableTrace para un proveedor determinado para habilitar esta característica.

Linkage

Reservado.

Reserved2

Reservado.

DataSize

Tamaño, en bytes, de los datos extendidos a los que Apunta DataPtr .

DataPtr

Puntero a los datos extendidos. El miembro ExtType determina el tipo de datos extendidos a los que apunta este miembro.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado evntcons.h (include Evntcons.h)

Consulte también

EVENT_RECORD