énumération EVENT_INFO_CLASS (evntprov.h)

Article
08/23/2023

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.exe`ressources 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

Share via