TRACE_QUERY_INFO_CLASS-Enumeration (evntrace.h)

Artikel
06/12/2024

Wird mit EnumerateTraceGuidsEx, TraceQueryInformation oder TraceSetInformation verwendet, um einen Typ von Ablaufverfolgungsinformationen anzugeben.

Beachten Sie, dass TRACE_INFO_CLASS und TRACE_QUERY_INFO_CLASS Typdefinitionen für dieselbe Enumeration sind.

Eine umfassendere Dokumentation darüber, mit welchen APIs die Werte in der Enumeration verwendet werden sollen, sowie die entsprechenden Puffereingabe- und Ausgabeformate sind in der TRACE_QUERY_INFO_CLASS Enumerationsdefinition in evntrace.hinline verfügbar.

Syntax

typedef enum _TRACE_QUERY_INFO_CLASS {
  TraceGuidQueryList = 0,
  TraceGuidQueryInfo = 1,
  TraceGuidQueryProcess = 2,
  TraceStackTracingInfo = 3,
  TraceSystemTraceEnableFlagsInfo = 4,
  TraceSampledProfileIntervalInfo = 5,
  TraceProfileSourceConfigInfo = 6,
  TraceProfileSourceListInfo = 7,
  TracePmcEventListInfo = 8,
  TracePmcCounterListInfo = 9,
  TraceSetDisallowList = 10,
  TraceVersionInfo = 11,
  TraceGroupQueryList = 12,
  TraceGroupQueryInfo = 13,
  TraceDisallowListQuery = 14,
  TraceInfoReserved15,
  TracePeriodicCaptureStateListInfo = 16,
  TracePeriodicCaptureStateInfo = 17,
  TraceProviderBinaryTracking = 18,
  TraceMaxLoggersQuery = 19,
  TraceLbrConfigurationInfo = 20,
  TraceLbrEventListInfo = 21,
  TraceMaxPmcCounterQuery = 22,
  TraceStreamCount = 23,
  TraceStackCachingInfo = 24,
  TracePmcCounterOwners = 25,
  TraceUnifiedStackCachingInfo = 26,
  TracePmcSessionInformation = 27,
  TraceContextRegisterInfo = 28,
  MaxTraceSetInfoClass = 29
} TRACE_QUERY_INFO_CLASS, TRACE_INFO_CLASS;

Konstanten


`TraceGuidQueryList` Wert: 0 Abfragen eines Arrays von GUIDs der Anbieter, die für die registriert sind Computer.
`TraceGuidQueryInfo` Wert: 1 Fragen Sie nach Informationen ab, die jede Sitzung zum Aktivieren des Anbieters verwendet hat.
`TraceGuidQueryProcess` Wert: 2 Abfragen eines Arrays von GUIDs der Anbieter, die sich im derselbe Prozess wie der aufrufende Prozess.
`TraceStackTracingInfo` Wert: 3 Fragen Sie die Einstellung für die Aufrufstapelablaufverfolgung für Kernelereignisse ab. Gibt ein Array von CLASSIC_EVENT_ID zurück Strukturen. Die Strukturen geben die Ereignis-GUIDs an, für die die Stapelablaufverfolgung gilt. erstellt wurde. Das Array ist auf 256 Elemente beschränkt. Der Wert wird unter Windows 7, Windows Server 2008 R2 und höher unterstützt.
`TraceSystemTraceEnableFlagsInfo` Wert: 4 Fragen Sie die Einstellung für enableFlags für den Systemablaufverfolgungsanbieter ab. Für Weitere Informationen finden Sie unter EVENT_TRACE_PROPERTIES Struktur. Der Wert wird unter Windows 8, Windows Server 2012 und höher unterstützt.
`TraceSampledProfileIntervalInfo` Wert: 5 Fragt die Einstellung für das Samplingprofilintervall für die angegebene Quelle ab. Der Wert wird unter Windows 8, Windows Server 2012 und höher unterstützt.
`TraceProfileSourceConfigInfo` Wert: 6 Konfiguriert die Liste der Profilerstellungsquellen, die erfasst werden, wenn Das Leistungsüberwachungsindikatorprofil wird ausgelöst. Die gesammelten Indikatoren werden als Teil des Ereignisses `PERF_PMC_PROFILE` ausgegeben werden. Der Wert wird unter Windows 8, Windows Server 2012 und höher unterstützt.
`TraceProfileSourceListInfo` Wert: 7 Fragt die Liste der im System verfügbaren Profilerstellungsquellen ab. Der Wert wird unter Windows 8, Windows Server 2012 und höher unterstützt.
`TracePmcEventListInfo` Wert: 8 Konfiguriert die Sitzung mit einer Liste von Systemereignissen, für die leistung Von `TracePmcCounterListInfo` konfigurierte Überwachungsindikatoren werden gesammelt. Der Wert wird unter Windows 8, Windows Server 2012 und höher unterstützt.
`TracePmcCounterListInfo` Wert: 9 Konfiguriert die Sitzung mit einer Liste von Profilerstellungsquellen, die gesammelt werden wenn von konfigurierte `TracePmcEventListInfo` Ereignisse in der Sitzung protokolliert werden. Der Wert wird unter Windows 8, Windows Server 2012 und höher unterstützt.
`TraceSetDisallowList` Wert: 10 Legen Sie die Liste der Anbieter fest, die nicht für diese Sitzung als Teil eines aktiviert werden. Anbietergruppenaktivierung. Weitere Informationen finden Sie unter Anbietermerkmale. Der Wert wird unter Windows 10, Windows Server 2016 und höher unterstützt.
`TraceVersionInfo` Wert: 11 Fragen Sie die Versionsinformationen der Ablaufverfolgungsdatei ab. Der Wert wird unter Windows 10, Windows Server 2016 und höher unterstützt.
`TraceGroupQueryList` Wert: 12 Abfragen eines Arrays von GUIDs der Anbietergruppen, die auf dem Computer aktiv sind.
`TraceGroupQueryInfo` Wert: 13 Der Wert wird unter Windows 10, Windows Server 2016 und höher unterstützt. Abfragen von Informationen, die jede Sitzung zum Aktivieren der Anbietergruppe verwendet hat.
`TraceDisallowListQuery` Wert: 14 Der Wert wird unter Windows 10, Windows Server 2016 und höher unterstützt. Abfragen eines Arrays von GUIDs, die für Gruppenfunktionen in dieser Sitzung nicht zulässig sind. Der Wert wird unter Windows 10, Windows Server 2016 und höher unterstützt.
`TraceInfoReserved15` Für die zukünftige Verwendung reserviert. Nicht verwenden.
`TracePeriodicCaptureStateListInfo` Wert: 16 Aktualisiert die Sitzung mit einer Liste von Anbietern, die regelmäßig die `EVENT_CONTROL_CODE_CAPTURE_STATE` Steuerungscode, ähnlich einem Aufruf von EnableTraceEx2. Weitere Informationen finden Sie unter TRACE_PERIODIC_CAPTURE_STATE_INFO. Der Wert wird unter Windows 10, Version 1709, Windows Server, Version unterstützt. 1709 und später.
`TracePeriodicCaptureStateInfo` Wert: 17 Fragt die Grenzwerte regelmäßiger Aufzeichnungszustandseinstellungen auf dem System ab, einschließlich die minimale Zeithäufigkeit und maximale Anzahl von Anbietern, die sein können gleichzeitig konfiguriert. Weitere Informationen finden Sie unter TRACE_PERIODIC_CAPTURE_STATE_INFO. Der Wert wird unter Windows 10, Version 1709, Windows Server, Version unterstützt. 1709 und später.
`TraceProviderBinaryTracking` Wert: 18 Weist ETW an, mit der Nachverfolgung von Binärdateien für alle Anbieter zu beginnen, die aktiviert sind die Sitzung. Die Nachverfolgung gilt für Anbieter, die für die Sitzung aktiviert sind. zum Zeitpunkt des Anrufs sowie bei allen zukünftigen Anbietern, die aktiviert sind die Sitzung. ETW generiert Nachverfolgungsereignisse, die eine Zuordnung zwischen Anbieter-GUID(s) enthalten und den Pfad zum Modul, das den Rückruf für den nachverfolgten Anbieter enthält. In im Fall einer Echtzeitsitzung werden die Ereignisse live in Echtzeit bereitgestellt Puffer. Im Fall einer dateibasierten Sitzung (d. h. wenn die Ablaufverfolgung in einem gespeichert wird ETL-Datei), werden die Ereignisse aggregiert und in den Dateiheader geschrieben. Das werden sie eines der ersten Ereignisse sein, die die ETW-Runtime bereitstellt, wenn die ETL-Datei wiedergegeben wird Zurück. Die binären Nachverfolgungsereignisse verfügen über die Anbieter-ID `EventTraceGuid` und opcode. `0x43`. Der Wert wird unter Windows 10, Version 1709, Windows Server, Version unterstützt. 1709 und später.
`TraceMaxLoggersQuery` Wert: 19 Fragt die derzeit konfigurierte maximale Anzahl zulässiger ETW-Protokollierungssitzungen ab. vom Betriebssystem. Gibt einen ULONG-Wert zurück. Wird verwendet mit EnumerateTraceGuidsEx. Der Wert wird unter Windows 10, Version 1709, Windows Server, Version unterstützt. 1709 und später.
`TraceLbrConfigurationInfo` Wert: 20 Aktiviert die Ablaufverfolgung des letzten Branchdatensatzes für die angegebene Sitzung und konfiguriert entsprechende LBR-Filter. Der Wert wird unter Windows 10, Version 19H1, Windows Server, Version unterstützt. 1903 und später.
`TraceLbrEventListInfo` Wert: 21 Konfiguriert die Liste der Ereignisse, die ETW zum Nachverfolgen des letzten Branchdatensatzes auslösen Informationen, die von konfiguriert sind `TraceLbrConfigurationInfo`. Der Wert wird unter Windows 10, Version 19H1, Windows Server, Version unterstützt. 1903 und später.
`TraceMaxPmcCounterQuery` Wert: 22 Fragt die maximale Anzahl von Profilerstellungsquellen ab, die gleichzeitig sein können für die Verwendung mit ETW konfiguriert. Der Wert wird unter Windows 10, Version 19H1, Windows Server, Version unterstützt. 1903 und später.
`TraceStreamCount` Wert: 23 Fragt die konfigurierte Streamanzahl für eine Sitzung ab. Dies ist normalerweise, aber nicht immer gleich der Anzahl der Prozessoren im System, oder 1, wenn nein Der Puffer pro Prozessor ist für die Sitzung konfiguriert. Der Wert wird unter Windows 10, Version 21H2, Windows Server 2022 und unterstützt. installieren.
`TraceStackCachingInfo` Wert: 24 Weist ETW an, mit dem Zwischenspeichern von Stapelablaufverfolgungen für RegisterTraceGuids-basierte zu beginnen. ("Classic")-Ereignisse in dieser Sitzung. Der Wert wird unter Windows 10, Version 21H2, Windows Server 2022 und unterstützt. installieren.
`TracePmcCounterOwners` Wert: 25 Fragt ETW nach einer Liste der derzeit in enthaltenen Leistungsindikatoren für die Prozessorleistungsüberwachung ab. Verwenden. Diese Liste kann Indikatoren enthalten, die von anderen Einrichtungen als ETW verwendet werden. Der Wert wird unter Windows 10, Version 21H2, Windows Server 2022 und unterstützt. installieren.
`TraceUnifiedStackCachingInfo` Wert: 26 Weist ETW an, mit dem Zwischenspeichern von Stapelablaufverfolgungen für beide RegisterTraceGuids-basierten zu beginnen. ("Classic") und EventRegister-basierte Ereignisse. Der Wert wird unter Windows 10, Version 21H2, Windows Server 2022 und unterstützt. installieren.
`TracePmcSessionInformation` Wert: 27 Abfragen aller Sitzungen nach ihrem PMC-Konfigurationssatz über `TracePmcEventListInfo` und `TracePmcCounterListInfo`. Der Wert wird unter Windows 10, Version 22H2 und höher unterstützt.
`TraceContextRegisterInfo` Wert: 28 Konfiguriert die Sitzung mit einer Liste von Systemereignissen, für die sich der Kontext registriert Ereignisse werden gesammelt. Kontextregisterereignisse enthalten CPU-Register inhalt zu dem Zeitpunkt, zu dem das angegebene verwandte Ereignis ausgelöst wird. Der Wert wird unter Windows Server 23H2 und höher unterstützt.
`MaxTraceSetInfoClass` Wert: 29 Markiert den letzten Wert in der Enumeration. Nicht verwenden.

Hinweise

Die TRACE_INFO_CLASS - und TRACE_QUERY_INFO_CLASS-Enumerationen definieren die gleichen Werte. Verwenden Sie beide Enumerationen mit der EnumerateTraceGuidsEx-Funktion oder der TraceSetInformation-Funktion .

Anforderungen

Anforderung	Wert
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

EnumerateTraceGuidsEx

TraceSetInformation

Freigeben über