Compartir a través de

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. En los ejemplos siguientes se muestran algunos valores posibles.

Valor Significado
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 enableProperty EVENT_ENABLE_PROPERTY_EVENT_KEY debe pasarse para la llamada de EnableTrace para que un proveedor determinado habilite esta característica.
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_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_PMC_COUNTERS
 El miembro DataPtr apunta a una estructura de EVENT_EXTENDED_ITEM_PMC_COUNTERS que contiene los valores de contador de PMC actuales. Para habilitar esta característica, los contadores de PMC válidos para la CPU deben establecerse a través de TraceSetInformation, con valores válidos Source encontrados llamando a TraceQueryInformation con TraceProfileSourceListInfo.
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.

El EVENT_ENABLE_PROPERTY_PROCESS_START_KEY EnableProperty debe pasarse para la llamada de EnableTrace para que un proveedor determinado habilite esta característica.
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 especificados a través de EVENT_DATA_DESCRIPTOR_TYPE_PROVIDER_METADATA.
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_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_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.

Linkage

Reservado.

Reserved2

Reservado.

DataSize

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

DataPtr

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

Requisitos

Requisito Valor
cliente mínimo admitido Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2008 [solo aplicaciones de escritorio]
encabezado de evntcons.h (incluya Evntcons.h)

Consulte también

EVENT_RECORD