Partager via

énumération EVENT_INFO_CLASS (evntprov.h)

  • Article

Le type d’énumération EVENT_INFO_CLASS est utilisé avec la fonction EventSetInformation pour spécifier l’opération de configuration à effectuer sur une inscription de fournisseur d’événements ETW.

Syntaxe

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

Constantes

 
EventProviderBinaryTrackInfo
Ajoute des informations de suivi binaire de ce fournisseur à chaque session qui
collecte les événements de ce fournisseur d’événements. Les données de suivi binaires incluent le
chemin d’accès complet au fichier binaire contenant le rappel qui a été spécifié lorsque
inscription du fournisseur d’événements. Ces informations sont utiles si le binaire
contient mc.exegénéré
décodage des ressources, mais n’est pas inscrit globalement. Les outils de décodage peuvent utiliser le
chemin d’accès dans la trace pour localiser le fichier binaire et extraire les ressources de décodage.

La mémoire tampon EventInformation n’est pas utilisée avec cette opération de configuration. The
Le runtime ETW utilise automatiquement le chemin d’accès complet du module de l’appelant (le
chemin d’accès complet à la DLL ou EXE qui contient la fonction de rappel spécifiée dans le
appelez à EventRegister). Pour que cette opération soit utile, la même DLL ou EXE
le fichier doit contenir les mc.exeressources de décodage générées.
EventProviderSetReserved1
Non utilisé.
EventProviderSetTraits
Définit des caractéristiques pour le fournisseur, telles que le nom du fournisseur. Indique qu’ETW
doit reconnaître le Type champ de
EVENT_DATA_DESCRIPTOR structures utilisées
avec ce fournisseur. Nécessite que le fournisseur initialise tous les champs du
EVENT_DATA_DESCRIPTOR structures, y compris le Reserved champ. (Le
le fournisseur doit généralement définir dataDescriptor.Reserved = 0, comme c’est le cas par
EventDataDescCreate.)

Notez que la structure EVENT_DATA_DESCRIPTOR contient un Type champ dans un
section de la structure qui était précédemment le Reserved champ. À éviter
problèmes de compatibilité avec les fournisseurs qui laissent le champ réservé non initialisé,
ETW ignore le champ (traitez-le Type comme 0), sauf si le fournisseur a utilisé
EventProviderSetTraits ou EventProviderUseDescriptorType dans un appel à
EventSetInformation.

La mémoire tampon EventInformation doit contenir le
traits de fournisseur à utiliser pour le
Fournisseur.
EventProviderUseDescriptorType
Spécifie si ETW doit reconnaître le Type champ de
EVENT_DATA_DESCRIPTOR structures utilisées
avec ce fournisseur. Si TRUE, nécessite que le fournisseur initialise tous les champs de
les structures EVENT_DATA_DESCRIPTOR , y compris le Reserved champ. (Le
le fournisseur doit généralement définir dataDescriptor.Reserved = 0, comme c’est le cas par
EventDataDescCreate.)

Notez que la structure EVENT_DATA_DESCRIPTOR contient un Type champ dans un
section de la structure qui était précédemment le Reserved champ. À éviter
problèmes de compatibilité avec les fournisseurs qui laissent le champ réservé non initialisé,
ETW ignore le champ (traitez-le Type comme 0), sauf si le fournisseur a utilisé
EventProviderSetTraits ou EventProviderUseDescriptorType dans un appel à
EventSetInformation.

La mémoire tampon EventInformation doit contenir une valeur BOOLEAN (1 octet, valeur)
FALSE ou TRUE).
MaxEventInfo
Premier code d’opération non valide. Cette valeur peut changer dans les versions suivantes
du Kit de développement logiciel (SDK) Windows.

Spécifications

   
Client minimal pris en charge Windows 8 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau | Applications UWP]
En-tête evntprov.h

Voir aussi

EventSetInformation

Caractéristiques du fournisseur