TRACE_QUERY_INFO_CLASS-Enumeration (evntrace.h)

  • Artikel

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,
  MaxTraceSetInfoClass = 28
} 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 auf Windows 10, Windows Server 2016 und höher unterstützt.
TraceVersionInfo
Wert: 11
Fragen Sie die Versionsinformationen der Ablaufverfolgungsdatei ab.

Der Wert wird auf 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 auf 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 auf 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 auf Windows 10, Windows Server 2016 und höher unterstützt.
TraceInfoReserved15
Für die zukünftige Verwendung reserviert. Darf nicht verwendet werden.
TracePeriodicCaptureStateListInfo
Wert: 16
Updates 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. Geben Sie 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
gehören zu den ersten Ereignissen, die die ETW-Runtime bereitstellt, wenn die ETL-Datei wiedergegeben wird
Zurück.

Die binären Nachverfolgungsereignisse weisen die Anbieter-ID EventTraceGuid und opcode auf.
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 aus. Gibt eine ULONG 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 von Last Branch Record 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 Verzweigungsdatensatzes auslösen.
Informationen, wie von TraceLbrConfigurationInfokonfiguriert.

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.
konfiguriert für die Verwendung mit ETW.

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 in der Regel, aber nicht
immer gleich der Anzahl der Prozessoren im System oder 1, wenn keine
Die Pufferung 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-basiert zu beginnen.
("Klassische") Ereignisse in dieser Sitzung.

Der Wert wird unter Windows 10, Version 21H2, Windows Server 2022 und unterstützt.
installieren.
TracePmcCounterOwners
Wert: 25
Fragt ETW ab, um eine Liste der Leistungsindikatoren für die Prozessorleistungsüberwachung zu erhalten, die derzeit in enthalten sind.
Verwenden. Diese Liste kann Leistungsindikatoren 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
Fragen Sie alle Sitzungen nach ihrem PMC-Konfigurationssatz über TracePmcEventListInfo und TracePmcCounterListInfoab.

Der Wert wird unter Windows 10, Version 22H2 und höher, unterstützt.
MaxTraceSetInfoClass
Wert: 28
Markiert den letzten Wert in der -Enumeration. Darf nicht verwendet werden.

Hinweise

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

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

EnumerateTraceGuidsEx

TraceSetInformation