Compartilhar via

enumeração EVENT_INFO_CLASS (evntprov.h)

  • Artigo

O tipo de enumeração EVENT_INFO_CLASS é usado com a função EventSetInformation para especificar a operação de configuração a ser executada em um registro de provedor de eventos ETW.

Syntax

typedef enum _EVENT_INFO_CLASS {
  EventProviderBinaryTrackInfo,
  EventProviderSetReserved1,
  EventProviderSetTraits,
  EventProviderUseDescriptorType,
  MaxEventInfo
} EVENT_INFO_CLASS;

Constantes

 
EventProviderBinaryTrackInfo
Adiciona informações de acompanhamento binário desse provedor a cada sessão que
coleta eventos desse provedor de eventos. Os dados de acompanhamento binário incluem o
caminho completo para o binário que contém o retorno de chamada que foi especificado quando
registrando o provedor de eventos. Essas informações serão úteis se o binário
contém mc.exegerado
decodificação de recursos, mas não está registrada globalmente. As ferramentas de decodificação podem usar o
caminho no rastreamento para localizar o binário e extrair os recursos de decodificação.

O buffer EventInformation não é usado com essa operação de configuração. O
O runtime do ETW usará automaticamente o caminho completo do módulo do chamador (o
caminho completo para a DLL ou EXE que contém a função de retorno de chamada especificada no
chamar para EventRegister). Para que essa operação seja útil, a mesma DLL ou EXE
o arquivo deve conter os mc.exerecursos de decodificação gerados.
EventProviderSetReserved1
Não usado.
EventProviderSetTraits
Define características para o provedor, como o nome do provedor. Indica que o ETW
deve reconhecer o Type campo de
estruturas de EVENT_DATA_DESCRIPTOR usadas
com esse provedor. Requer que o provedor inicialize todos os campos do
EVENT_DATA_DESCRIPTOR estruturas, incluindo o Reserved campo . (O
o provedor geralmente deve definir dataDescriptor.Reserved = 0, como é feito por
EventDataDescCreate.)

Observe que a estrutura EVENT_DATA_DESCRIPTOR contém um Type campo em um
da estrutura que anteriormente era o Reserved campo. Para evitar
problemas de compatibilidade com provedores que deixam o campo Reservado não inicializado,
O ETW ignorará o campo (trate-o Type como 0), a menos que o provedor tenha usado
EventProviderSetTraits ou EventProviderUseDescriptorType em uma chamada para
EventSetInformation.

O buffer EventInformation deve conter o
características do provedor a serem usadas para o
provedor.
EventProviderUseDescriptorType
Especifica se o ETW deve reconhecer o Type campo de
estruturas de EVENT_DATA_DESCRIPTOR usadas
com esse provedor. Se TRUE, exigirá que o provedor inicialize todos os campos de
as estruturas EVENT_DATA_DESCRIPTOR , incluindo o Reserved campo . (O
o provedor geralmente deve definir dataDescriptor.Reserved = 0, como é feito por
EventDataDescCreate.)

Observe que a estrutura EVENT_DATA_DESCRIPTOR contém um Type campo em um
da estrutura que anteriormente era o Reserved campo. Para evitar
problemas de compatibilidade com provedores que deixam o campo Reservado não inicializado,
O ETW ignorará o campo (trate-o Type como 0), a menos que o provedor tenha usado
EventProviderSetTraits ou EventProviderUseDescriptorType em uma chamada para
EventSetInformation.

O buffer EventInformation deve conter um valor BOOLEAN (1 byte, valor
FALSE ou TRUE).
MaxEventInfo
O primeiro código de operação inválido. Esse valor pode ser alterado nas versões subsequentes
do SDK do Windows.

Requisitos

   
Cliente mínimo com suporte Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
Cabeçalho evntprov.h

Confira também

EventSetInformation

Características do provedor