ENABLE_TRACE_PARAMETERS_V1-Struktur (evntrace.h)

  • Artikel

Die ENABLE_TRACE_PARAMETERS_V1-Struktur enthält Informationen, die zum Aktivieren eines Anbieters über EnableTraceEx2 verwendet werden. Diese Struktur ist veraltet. Verwenden Sie stattdessen ENABLE_TRACE_PARAMETERS .

Syntax

typedef struct _ENABLE_TRACE_PARAMETERS_V1 {
  ULONG                    Version;
  ULONG                    EnableProperty;
  ULONG                    ControlFlags;
  GUID                     SourceId;
  PEVENT_FILTER_DESCRIPTOR EnableFilterDesc;
} ENABLE_TRACE_PARAMETERS_V1, *PENABLE_TRACE_PARAMETERS_V1;

Member

Version

Legen Sie auf ENABLE_TRACE_PARAMETERS_VERSION (1) fest.

EnableProperty

Optionale Informationen, die ETW beim Schreiben des Ereignisses enthalten kann. Die Daten werden in den Abschnitt des erweiterten Datenelements des Ereignisses geschrieben. Um die optionalen Informationen einzuschließen, geben Sie mindestens eins der folgenden Flags an: legen Sie andernfalls auf 0 fest.

  • EVENT_ENABLE_PROPERTY_SID

    Fügen Sie die Sicherheits-ID (SID) des Benutzers in die erweiterten Daten ein.

  • EVENT_ENABLE_PROPERTY_TS_ID

    Fügen Sie den Terminalsitzungsbezeichner in die erweiterten Daten ein.

  • EVENT_ENABLE_PROPERTY_STACK_TRACE

    Fügen Sie den erweiterten Daten von Ereignissen, die mit EventWrite geschrieben wurden, eine Aufrufstapelablaufverfolgung hinzu.

    Hinweis

    ETW löscht das Ereignis, wenn die Gesamtereignisgröße 64K überschreitet. Wenn der Anbieter Ereignisse in der Größe von maximal 64 KB protokolliert, ist es möglich, dass die Aktivierung der Stapelerfassung dazu führt, dass das Ereignis verloren geht.

    Wenn der Stapel länger als die maximale Anzahl von Frames (192) ist, werden die Frames vom unteren Rand des Stapels ausgeschnitten.

    Für Consumer umfassen die Ereignisse das EVENT_EXTENDED_ITEM_STACK_TRACE32 oder EVENT_EXTENDED_ITEM_STACK_TRACE64 erweiterte Element. Beachten Sie, dass 32-Bit-Consumer möglicherweise 64-Bit-Stapelablaufverfolgungen von 64-Bit-Prozessen erhalten.

ControlFlags

Reserviert. Auf 0 festlegen.

SourceId

Eine GUID, die den Aufrufer eindeutig identifiziert, der den Anbieter aktiviert oder deaktiviert. Wenn der Anbieter EnableCallback nicht implementiert, wird die GUID nicht verwendet.

EnableFilterDesc

Eine EVENT_FILTER_DESCRIPTOR Struktur, die auf die Filterdaten verweist. Der Anbieter verwendet Filterdaten, um zu verhindern, dass Ereignisse, die den Filterkriterien entsprechen, in die Sitzung geschrieben werden. Der Anbieter bestimmt das Layout der Daten und wie er den Filter auf die Ereignisdaten anwendet. Eine Sitzung kann nur einen Filter an den Anbieter übergeben.

Eine Sitzung kann die TdhEnumerateProviderFilters-Funktion aufrufen, um die schematisierten Filter zu bestimmen, die sie an den Anbieter übergeben kann.

Hinweise

ENABLE_TRACE_PARAMETERS_V1 ist veraltet. Die ENABLE_TRACE_PARAMETERS-Struktur ist eine Struktur der Version 2 und ersetzt die ENABLE_TRACE_PARAMETERS_V1-Struktur .

In der Regel können Sie auf 64-Bit-Computern den Kernelstapel in bestimmten Kontexten nicht erfassen, wenn Seitenfehler nicht zulässig sind. Um das Durchlaufen des Kernelstapels auf x64 zu aktivieren, legen Sie den Registrierungswert der DisablePagingExecutive Speicherverwaltung auf 1 fest. Der DisablePagingExecutive Registrierungswert befindet sich unter dem folgenden Registrierungsschlüssel: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Memory Management. Dies sollte nur für temporäre Diagnosezwecke erfolgen, da dadurch die Arbeitsspeicherauslastung des Systems erhöht wird.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Kopfzeile evntrace.h

Weitere Informationen

ENABLE_TRACE_PARAMETERS

EVENT_FILTER_DESCRIPTOR

EnableTraceEx2