estructura de TRACE_EVENT_INFO (tdh.h)

Artículo
03/08/2023

Define la información sobre el evento.

Sintaxis

typedef struct _TRACE_EVENT_INFO {
  GUID                ProviderGuid;
  GUID                EventGuid;
  EVENT_DESCRIPTOR    EventDescriptor;
  DECODING_SOURCE     DecodingSource;
  ULONG               ProviderNameOffset;
  ULONG               LevelNameOffset;
  ULONG               ChannelNameOffset;
  ULONG               KeywordsNameOffset;
  ULONG               TaskNameOffset;
  ULONG               OpcodeNameOffset;
  ULONG               EventMessageOffset;
  ULONG               ProviderMessageOffset;
  ULONG               BinaryXMLOffset;
  ULONG               BinaryXMLSize;
  union {
    ULONG EventNameOffset;
    ULONG ActivityIDNameOffset;
  };
  union {
    ULONG EventAttributesOffset;
    ULONG RelatedActivityIDNameOffset;
  };
  ULONG               PropertyCount;
  ULONG               TopLevelPropertyCount;
  union {
    TEMPLATE_FLAGS Flags;
    struct {
      ULONG Reserved : 4;
      ULONG Tags : 28;
    };
  };
  EVENT_PROPERTY_INFO EventPropertyInfoArray[ANYSIZE_ARRAY];
} TRACE_EVENT_INFO;

Miembros

ProviderGuid

GUID que identifica el proveedor.

EventGuid

GUID que identifica la clase MOF que contiene el evento. Si el proveedor usa un manifiesto para definir sus eventos, este miembro se GUID_NULL.

EventDescriptor

Estructura EVENT_DESCRIPTOR que describe el evento.

DecodingSource

Valor de enumeración DECODING_SOURCE que identifica el origen utilizado para analizar los datos del evento (por ejemplo, un manifiesto de instrumentación de la clase MOF de WMI).

ProviderNameOffset

Desplazamiento desde el principio de esta estructura a una cadena Unicode terminada en null que contiene el nombre del proveedor.

LevelNameOffset

Desplazamiento desde el principio de esta estructura a una cadena Unicode terminada en null que contiene el nombre del nivel. Para conocer los posibles nombres, vea Comentarios en LevelType.

ChannelNameOffset

Desplazamiento desde el principio de esta estructura a una cadena Unicode terminada en null que contiene el nombre del canal. Para conocer los posibles nombres, vea Comentarios en ChannelType.

KeywordsNameOffset

Desplazamiento desde el principio de esta estructura a una lista de cadenas Unicode terminadas en null que contiene los nombres de las palabras clave. La lista finaliza con dos caracteres NULL. Para conocer los posibles nombres, vea Comentarios en KeywordType.

TaskNameOffset

Desplazamiento desde el principio de esta estructura a una cadena Unicode terminada en null que contiene el nombre de la tarea. Para conocer los posibles nombres, vea Comentarios en TaskType.

OpcodeNameOffset

Desplazamiento desde el principio de esta estructura a una cadena Unicode terminada en null que contiene el nombre de la operación. Para conocer los posibles nombres, vea Comentarios en OpcodeType.

EventMessageOffset

Desplazamiento desde el principio de esta estructura a una cadena Unicode terminada en null que contiene la cadena del mensaje de evento. El desplazamiento es cero si no hay ninguna cadena de mensaje. Para obtener información sobre las cadenas de mensajes, consulte el atributo message para EventDefinitionType.

La cadena de mensaje puede contener secuencias de inserción, por ejemplo, No se puede conectar a la impresora %1. El número de la secuencia de inserción identifica la propiedad en los datos de evento que se van a usar para la sustitución.

ProviderMessageOffset

Desplazamiento desde el principio de esta estructura a una cadena Unicode terminada en null que contiene el nombre del proveedor localizado.

BinaryXMLOffset

Reservado.

BinaryXMLSize

Reservado.

EventNameOffset

ActivityIDNameOffset

Desplazamiento desde el principio de esta estructura a una cadena Unicode terminada en null que contiene el nombre de propiedad del identificador de actividad en la clase MOF. Solo se admite para eventos ETW clásicos.

EventAttributesOffset

RelatedActivityIDNameOffset

Desplazamiento desde el principio de esta estructura a una cadena Unicode terminada en null que contiene el nombre de propiedad del identificador de actividad relacionado en la clase MOF. Solo se admite para eventos ETW heredados.

PropertyCount

Número de elementos de la matriz EventPropertyInfoArray .

TopLevelPropertyCount

Número de propiedades de la matriz EventPropertyInfoArray que son propiedades de nivel superior. Este número no incluye miembros de estructuras. Las propiedades de nivel superior vienen antes de todas las propiedades de miembro de la matriz.

Flags

Reservado.

Reserved

Tags

Valor de 28 bits asociado a los metadatos del evento. El proveedor de eventos puede usar este valor para asociar datos semánticos adicionales con un evento para que lo use una herramienta de procesamiento de eventos. Por ejemplo, un valor de etiqueta de 5 podría indicar que el evento contiene información de depuración. La semántica de cualquier valor de este campo se define mediante el proveedor de eventos.

EventPropertyInfoArray[ANYSIZE_ARRAY]

Matriz de estructuras de EVENT_PROPERTY_INFO que proporciona información sobre cada propiedad de los datos de usuario del evento.

Comentarios

El valor de un desplazamiento es cero si el miembro no está definido.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	tdh.h