estructura de TRACE_EVENT_INFO (tdh.h)
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 |