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