EVENT_INFO_CLASS Enumeration (evntprov.h)

Artikel
08/23/2023

Der EVENT_INFO_CLASS Enumerationstyp wird mit der EventSetInformation-Funktion verwendet, um den Konfigurationsvorgang anzugeben, der für eine ETW-Ereignisanbieterregistrierung ausgeführt werden soll.

Syntax

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

Konstanten


`EventProviderBinaryTrackInfo` Fügt jeder Sitzung binäre Nachverfolgungsinformationen von diesem Anbieter hinzu, die erfasst Ereignisse von diesem Ereignisanbieter. Die binären Nachverfolgungsdaten umfassen die vollständiger Pfad zur Binärdatei mit dem Rückruf, der angegeben wurde, wenn Registrieren des Ereignisanbieters. Diese Informationen sind nützlich, wenn die Binärdatei enthält mc.exe-generiert Decodierung von Ressourcen, aber nicht global registriert. Decodierungstools können die Pfad in der Ablaufverfolgung, um die Binärdatei zu suchen und die Decodierungsressourcen zu extrahieren. Der EventInformation-Puffer wird bei diesem Konfigurationsvorgang nicht verwendet. The DIE ETW-Runtime verwendet automatisch den vollständigen Pfad des Moduls des Aufrufers (die vollständiger Pfad zur DLL oder EXE, die die rückruffunktion enthält, die im Aufruf von EventRegister). Damit dieser Vorgang nützlich ist, muss dieselbe DLL oder EXE verwendet werden. -Datei muss die generierten `mc.exe`Decodierungsressourcen enthalten.
`EventProviderSetReserved1` Wird nicht verwendet.
`EventProviderSetTraits` Legt Merkmale für den Anbieter fest, z. B. den Namen des Anbieters. Gibt an, dass ETW sollte das `Type` Feld von erkennen EVENT_DATA_DESCRIPTOR verwendeten Strukturen mit diesem Anbieter. Erfordert, dass der Anbieter alle Felder des EVENT_DATA_DESCRIPTOR Strukturen, einschließlich des `Reserved` Felds. (Die Der Anbieter sollte in der Regel festlegen `dataDescriptor.Reserved = 0`, wie von EventDataDescCreate.) Beachten Sie, dass die EVENT_DATA_DESCRIPTOR-Struktur ein Feld in einem `Type` - Abschnitt der Struktur, die zuvor das `Reserved` Feld war. So vermeiden Sie Kompatibilitätsprobleme mit Anbietern, die das Feld Reserviert nicht initialisiert lassen, ETW ignoriert das `Type` Feld (behandelt es als 0), es sei denn, der Anbieter hat verwendet. EventProviderSetTraits oder EventProviderUseDescriptorType in einem Aufruf von EventSetInformation. Der EventInformation-Puffer sollte die Anbietereigenschaften , die für die Anbieters angezeigt.
`EventProviderUseDescriptorType` Gibt an, ob ETW das `Type` Feld von erkennen soll. EVENT_DATA_DESCRIPTOR verwendeten Strukturen mit diesem Anbieter. Wenn `TRUE`, muss der Anbieter alle Felder von initialisieren. die EVENT_DATA_DESCRIPTOR Strukturen, einschließlich des Felds `Reserved` . (Die Der Anbieter sollte in der Regel festlegen `dataDescriptor.Reserved = 0`, wie von EventDataDescCreate.) Beachten Sie, dass die EVENT_DATA_DESCRIPTOR-Struktur ein Feld in einem `Type` - Abschnitt der Struktur, die zuvor das `Reserved` Feld war. So vermeiden Sie Kompatibilitätsprobleme mit Anbietern, die das Feld Reserviert nicht initialisiert lassen, ETW ignoriert das `Type` Feld (behandelt es als 0), es sei denn, der Anbieter hat verwendet. EventProviderSetTraits oder EventProviderUseDescriptorType in einem Aufruf von EventSetInformation. Der EventInformation-Puffer sollte einen BOOLEAN-Wert (1 Byte, Wert) enthalten. `FALSE` oder `TRUE`).
`MaxEventInfo` Der erste ungültige Vorgangscode. Dieser Wert kann sich in nachfolgenden Versionen ändern. des Windows SDK.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 8 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [Desktop-Apps \| UWP-Apps]
Kopfzeile	evntprov.h

Weitere Informationen

EventSetInformation

Anbietermerkmale