estrutura TRACE_EVENT_INFO (tdh.h)

Artigo
08/26/2023

Define as informações sobre o evento.

Sintaxe

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;

Membros

ProviderGuid

Um GUID que identifica o provedor.

EventGuid

Um GUID que identifica a classe MOF que contém o evento. Se o provedor usar um manifesto para definir seus eventos, esse membro será GUID_NULL.

EventDescriptor

Uma estrutura EVENT_DESCRIPTOR que descreve o evento.

DecodingSource

Um DECODING_SOURCE valor de enumeração que identifica a origem usada para analisar os dados do evento (por exemplo, um manifesto de instrumentação da classe WMI MOF).

ProviderNameOffset

O deslocamento do início dessa estrutura para uma cadeia de caracteres Unicode terminada em nulo que contém o nome do provedor.

LevelNameOffset

O deslocamento do início dessa estrutura para uma cadeia de caracteres Unicode terminada em nulo que contém o nome do nível. Para obter nomes possíveis, consulte Comentários em LevelType.

ChannelNameOffset

O deslocamento do início dessa estrutura para uma cadeia de caracteres Unicode terminada em nulo que contém o nome do canal. Para obter nomes possíveis, consulte Comentários em ChannelType.

KeywordsNameOffset

O deslocamento do início dessa estrutura para uma lista de cadeias de caracteres Unicode terminadas em nulo que contém os nomes das palavras-chave. A lista é encerrada com dois caracteres NULL. Para obter nomes possíveis, consulte Comentários em KeywordType.

TaskNameOffset

O deslocamento do início dessa estrutura para uma cadeia de caracteres Unicode terminada em nulo que contém o nome da tarefa. Para obter nomes possíveis, consulte Comentários em TaskType.

OpcodeNameOffset

O deslocamento do início dessa estrutura para uma cadeia de caracteres Unicode terminada em nulo que contém o nome da operação. Para obter nomes possíveis, consulte Comentários em OpcodeType.

EventMessageOffset

O deslocamento do início dessa estrutura para uma cadeia de caracteres Unicode terminada em nulo que contém a cadeia de caracteres de mensagem de evento. O deslocamento será zero se não houver nenhuma cadeia de caracteres de mensagem. Para obter informações sobre cadeias de caracteres de mensagem, consulte o atributo de mensagempara EventDefinitionType.

A cadeia de caracteres de mensagem pode conter sequências de inserção, por exemplo, Não é possível se conectar à impressora %1. O número da sequência de inserção identifica a propriedade nos dados de evento a serem usados para a substituição.

ProviderMessageOffset

O deslocamento do início dessa estrutura para uma cadeia de caracteres Unicode terminada em nulo que contém o nome do provedor localizado.

BinaryXMLOffset

Reservado.

BinaryXMLSize

Reservado.

EventNameOffset

ActivityIDNameOffset

O deslocamento do início dessa estrutura para uma cadeia de caracteres Unicode terminada em nulo que contém o nome da propriedade do identificador de atividade na classe MOF. Com suporte apenas para eventos ETW clássicos.

EventAttributesOffset

RelatedActivityIDNameOffset

O deslocamento do início dessa estrutura para uma cadeia de caracteres Unicode terminada em nulo que contém o nome da propriedade do identificador de atividade relacionado na classe MOF. Com suporte apenas para eventos ETW herdados.

PropertyCount

O número de elementos na matriz EventPropertyInfoArray .

TopLevelPropertyCount

O número de propriedades na matriz EventPropertyInfoArray que são propriedades de nível superior. Esse número não inclui membros de estruturas. As propriedades de nível superior vêm antes de todas as propriedades de membro na matriz.

Flags

Reservado.

Reserved

Tags

Um valor de 28 bits associado aos metadados do evento. Esse valor pode ser usado pelo provedor de eventos para associar dados semânticos adicionais a um evento para uso por uma ferramenta de processamento de eventos. Por exemplo, um valor de marca de 5 pode indicar que o evento contém informações de depuração. A semântica de quaisquer valores nesse campo é definida pelo provedor de eventos.

EventPropertyInfoArray[ANYSIZE_ARRAY]

Uma matriz de estruturas de EVENT_PROPERTY_INFO que fornece informações sobre cada propriedade dos dados do usuário do evento.

Comentários

O valor de um deslocamento será zero se o membro não estiver definido.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho	tdh.h