enumerazione EVENT_INFO_CLASS (evntprov.h)

  • Articolo

Il tipo di enumerazione EVENT_INFO_CLASS viene usato con la funzione EventSetInformation per specificare l'operazione di configurazione da eseguire su una registrazione del provider di eventi ETW.

Sintassi

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

Costanti

 
EventProviderBinaryTrackInfo
Aggiunge informazioni di rilevamento binario da questo provider a ogni sessione che
raccoglie gli eventi da questo provider di eventi. I dati di rilevamento binario includono
percorso completo del file binario contenente il callback specificato quando
registrazione del provider di eventi. Queste informazioni sono utili se il file binario
contiene mc.exegenerato
decodifica delle risorse ma non registrata a livello globale. Gli strumenti di decodifica possono usare
percorso nella traccia per individuare il file binario ed estrarre le risorse di decodifica.

Il buffer EventInformation non viene usato con questa operazione di configurazione. The
Il runtime ETW userà automaticamente il percorso completo del modulo del chiamante (il
percorso completo della DLL o exe che contiene la funzione di callback specificata in
chiamare a EventRegister). Per rendere utile questa operazione, la stessa DLL o EXE
il file deve contenere le mc.exerisorse di decodifica generate da .
EventProviderSetReserved1
Non usato.
EventProviderSetTraits
Imposta i tratti per il provider, ad esempio il nome del provider. Indica che ETW
deve riconoscere il Type campo di
EVENT_DATA_DESCRIPTOR strutture utilizzate
con questo provider. Richiede al provider di inizializzare tutti i campi del
EVENT_DATA_DESCRIPTOR strutture, incluso il Reserved campo . (Il
il provider deve in genere impostare dataDescriptor.Reserved = 0, come avviede da
EventDataDescCreate.

Si noti che la struttura EVENT_DATA_DESCRIPTOR contiene un Type campo in un
sezione della struttura precedente al Reserved campo . Per evitare
problemi di compatibilità con i provider che lasciano il campo Riservato non inizializzato,
ETW ignorerà il Type campo (considerarlo come 0) a meno che il provider non abbia usato
EventProviderSetTraits o EventProviderUseDescriptorType in una chiamata a
EventSetInformation.

Il buffer EventInformation deve contenere il
tratti del provider da usare per
e del provider.
EventProviderUseDescriptorType
Specifica se ETW deve riconoscere il Type campo di
EVENT_DATA_DESCRIPTOR strutture utilizzate
con questo provider. Se TRUE, richiede al provider di inizializzare tutti i campi di
le strutture EVENT_DATA_DESCRIPTOR , incluso il Reserved campo . (Il
il provider deve in genere impostare dataDescriptor.Reserved = 0, come avviede da
EventDataDescCreate.

Si noti che la struttura EVENT_DATA_DESCRIPTOR contiene un Type campo in un
sezione della struttura precedente al Reserved campo . Per evitare
problemi di compatibilità con i provider che lasciano il campo Riservato non inizializzato,
ETW ignorerà il Type campo (considerarlo come 0) a meno che il provider non abbia usato
EventProviderSetTraits o EventProviderUseDescriptorType in una chiamata a
EventSetInformation.

Il buffer EventInformation deve contenere un valore BOOLEAN (1 byte, valore
FALSE o TRUE).
MaxEventInfo
Il primo codice dell'operazione non valido. Questo valore può cambiare nelle versioni successive
di Windows SDK.

Requisiti

   
Client minimo supportato Windows 8 [app desktop | App UWP]
Server minimo supportato Windows Server 2012 [app desktop | App UWP]
Intestazione evntprov.h

Vedi anche

EventSetInformation

Tratti del provider