EVENT_INFO_CLASS Enumeration (evntprov.h)

  • Artikel

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.exeDecodierungsressourcen 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