TRACE_EVENT_INFO struttura (tdh.h)

Articolo
03/02/2024

Definisce le informazioni sull'evento.

Sintassi

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;

Members

ProviderGuid

GUID che identifica il provider.

EventGuid

GUID che identifica la classe MOF che contiene l'evento. Se il provider usa un manifesto per definire gli eventi, questo membro viene GUID_NULL.

EventDescriptor

Struttura EVENT_DESCRIPTOR che descrive l'evento.

DecodingSource

Valore di enumerazione DECODING_SOURCE che identifica l'origine usata per analizzare i dati dell'evento, ad esempio un manifesto di strumentazione della classe WMI MOF.

ProviderNameOffset

Offset dall'inizio di questa struttura a una stringa Unicode con terminazione null contenente il nome del provider.

LevelNameOffset

Offset dall'inizio di questa struttura a una stringa Unicode con terminazione null contenente il nome del livello. Per i nomi possibili, vedere Osservazioni in LevelType.

ChannelNameOffset

Offset dall'inizio di questa struttura a una stringa Unicode con terminazione null contenente il nome del canale. Per i nomi possibili, vedere Osservazioni in ChannelType.

KeywordsNameOffset

Offset dall'inizio di questa struttura a un elenco di stringhe Unicode con terminazione null che contiene i nomi delle parole chiave. L'elenco viene terminato con due caratteri NULL. Per i nomi possibili, vedere Osservazioni in KeywordType.

TaskNameOffset

Offset dall'inizio di questa struttura a una stringa Unicode con terminazione null contenente il nome dell'attività. Per i nomi possibili, vedere Osservazioni in TaskType.

OpcodeNameOffset

Offset dall'inizio di questa struttura a una stringa Unicode con terminazione null contenente il nome dell'operazione. Per i nomi possibili, vedere Osservazioni in OpcodeType.

EventMessageOffset

Offset dall'inizio di questa struttura a una stringa Unicode con terminazione null contenente la stringa del messaggio di evento. L'offset è zero se non esiste alcuna stringa di messaggio. Per informazioni sulle stringhe di messaggio, vedere l'attributo message per EventDefinitionType.

La stringa di messaggio può contenere sequenze di inserimento, ad esempio, Impossibile connettersi alla stampante %1. Il numero della sequenza di inserimento identifica la proprietà nei dati dell'evento da usare per la sostituzione.

ProviderMessageOffset

Offset dall'inizio di questa struttura a una stringa Unicode con terminazione null contenente il nome del provider localizzato.

BinaryXMLOffset

Riservato.

BinaryXMLSize

Riservato.

EventNameOffset

ActivityIDNameOffset

Offset dall'inizio di questa struttura a una stringa Unicode con terminazione null contenente il nome della proprietà dell'identificatore di attività nella classe MOF. Supportato solo per gli eventi ETW classici.

EventAttributesOffset

RelatedActivityIDNameOffset

Offset dall'inizio di questa struttura a una stringa Unicode con terminazione null contenente il nome della proprietà dell'identificatore di attività correlato nella classe MOF. Supportato solo per gli eventi ETW legacy.

PropertyCount

Numero di elementi nella matrice EventPropertyInfoArray .

TopLevelPropertyCount

Numero di proprietà nella matrice EventPropertyInfoArray che sono proprietà di primo livello. Questo numero non include membri di strutture. Le proprietà di primo livello vengono prima di tutte le proprietà membro nella matrice.

Flags

Riservato.

Reserved

Tags

Valore a 28 bit associato ai metadati dell'evento. Questo valore può essere usato dal provider di eventi per associare dati semantici aggiuntivi a un evento da usare da uno strumento di elaborazione eventi. Ad esempio, un valore di tag pari a 5 potrebbe indicare che l'evento contiene informazioni di debug. La semantica di tutti i valori in questo campo è definita dal provider di eventi.

EventPropertyInfoArray[ANYSIZE_ARRAY]

Matrice di strutture EVENT_PROPERTY_INFO che fornisce informazioni su ogni proprietà dei dati utente dell'evento.