enumerazione TRACE_QUERY_INFO_CLASS (evntrace.h)

Articolo
03/11/2023

Usato con EnumerateTraceGuidsEx, TraceQueryInformation o TraceSetInformation per specificare un tipo di informazioni di traccia.

Si noti che TRACE_INFO_CLASS e TRACE_QUERY_INFO_CLASS sono typedef per la stessa enumerazione.

La documentazione più completa sulle API con cui devono essere usati i valori nell'enumerazione TRACE_QUERY_INFO_CLASS , nonché i formati di input e output del buffer corrispondenti sono disponibili in riga nella definizione di enumerazione in evntrace.h.

Sintassi

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;

Costanti


`TraceGuidQueryList` Valore: 0 Eseguire una query per una matrice di GUID dei provider registrati nell'oggetto computer.
`TraceGuidQueryInfo` Valore: 1 Eseguire una query per informazioni usate per abilitare il provider.
`TraceGuidQueryProcess` Valore: 2 Eseguire una query per una matrice di GUID dei provider che si sono registrati nell'oggetto stesso processo di chiamata.
`TraceStackTracingInfo` Valore: 3 Eseguire una query sull'impostazione per la traccia dello stack di chiamate per gli eventi del kernel. Restituisce una matrice di CLASSIC_EVENT_ID Strutture. Le strutture specificano i GUID evento per cui la traccia dello stack è Abilitato. La matrice è limitata a 256 elementi. Il valore è supportato in Windows 7, Windows Server 2008 R2 e versioni successive.
`TraceSystemTraceEnableFlagsInfo` Valore: 4 Eseguire una query sull'impostazione per EnableFlags per il provider di traccia di sistema. For altre informazioni, vedere EVENT_TRACE_PROPERTIES struttura. Il valore è supportato in Windows 8, Windows Server 2012 e versioni successive.
`TraceSampledProfileIntervalInfo` Valore: 5 Esegue una query sull'impostazione dell'intervallo di profilo di campionamento per l'origine specificata. Il valore è supportato in Windows 8, Windows Server 2012 e versioni successive.
`TraceProfileSourceConfigInfo` Valore: 6 Configura l'elenco delle origini di profilatura che verranno raccolte quando viene generato l'evento del profilo del contatore del monitoraggio delle prestazioni. I contatori raccolti verranno raccolti essere generato come parte dell'evento `PERF_PMC_PROFILE` . Il valore è supportato in Windows 8, Windows Server 2012 e versioni successive.
`TraceProfileSourceListInfo` Valore: 7 Esegue query sull'elenco delle origini di profilatura disponibili nel sistema. Il valore è supportato in Windows 8, Windows Server 2012 e versioni successive.
`TracePmcEventListInfo` Valore: 8 Configura la sessione con un elenco di eventi di sistema per cui le prestazioni i contatori di monitoraggio configurati da `TracePmcCounterListInfo` verranno raccolti. Il valore è supportato in Windows 8, Windows Server 2012 e versioni successive.
`TracePmcCounterListInfo` Valore: 9 Configura la sessione con un elenco di origini di profilatura che verranno raccolte quando gli eventi configurati da `TracePmcEventListInfo` vengono registrati nella sessione. Il valore è supportato in Windows 8, Windows Server 2012 e versioni successive.
`TraceSetDisallowList` Valore: 10 Impostare l'elenco di provider che non saranno abilitati a questa sessione come parte di un abilitazione del gruppo di provider. Per ulteriori informazioni, vedere Tratti del provider. Il valore è supportato in Windows 10, Windows Server 2016 e versioni successive.
`TraceVersionInfo` Valore: 11 Eseguire query sulle informazioni sulla versione del file di traccia. Il valore è supportato in Windows 10, Windows Server 2016 e versioni successive.
`TraceGroupQueryList` Valore: 12 Eseguire una query su una matrice di GUID dei gruppi di provider attivi nel computer.
`TraceGroupQueryInfo` Valore: 13 Il valore è supportato in Windows 10, Windows Server 2016 e versioni successive. Eseguire query sulle informazioni usate per abilitare il gruppo di provider.
`TraceDisallowListQuery` Valore: 14 Il valore è supportato in Windows 10, Windows Server 2016 e versioni successive. Eseguire una query su una matrice di GUID non consentiti per il gruppo abilita in questa sessione. Il valore è supportato in Windows 10, Windows Server 2016 e versioni successive.
`TraceInfoReserved15` Riservato per utilizzi futuri. Non usare.
`TracePeriodicCaptureStateListInfo` Valore: 16 Aggiornamenti la sessione con un elenco di provider che riceveranno periodicamente `EVENT_CONTROL_CODE_CAPTURE_STATE` codice di controllo, simile a una chiamata da EnableTraceEx2. Per ulteriori informazioni, vedere TRACE_PERIODIC_CAPTURE_STATE_INFO. Il valore è supportato in Windows 10, versione 1709, Windows Server, versione 1709 e versioni successive.
`TracePeriodicCaptureStateInfo` Valore: 17 Esegue query sui limiti delle impostazioni di stato di acquisizione periodice nel sistema, tra cui frequenza minima di tempo e numero massimo di provider che possono essere configurata contemporaneamente. Per ulteriori informazioni, vedere TRACE_PERIODIC_CAPTURE_STATE_INFO. Il valore è supportato in Windows 10, versione 1709, Windows Server, versione 1709 e versioni successive.
`TraceProviderBinaryTracking` Valore: 18 Indica a ETW di iniziare a tenere traccia dei file binari per tutti i provider abilitati sessione. Il rilevamento si applica ai provider abilitati alla sessione al momento della chiamata e a tutti i provider futuri abilitati sessione. ETW genera eventi di rilevamento che contengono un mapping tra GUID del provider e il percorso del modulo contenente il callback per il provider monitorato. In caso di una sessione in tempo reale, gli eventi vengono forniti in tempo reale in tempo reale Buffer. Nel caso di una sessione basata su file , ad esempio se la traccia viene salvata in un oggetto File con estensione etl), gli eventi vengono aggregati e scritti nell'intestazione del file; Lo faranno essere tra i primi eventi forniti dal runtime ETW quando viene riprodotto il file con estensione etl Indietro. Gli eventi di rilevamento binario avranno ID `EventTraceGuid` provider e opcode `0x43`. Il valore è supportato in Windows 10, versione 1709, Windows Server, versione 1709 e versioni successive.
`TraceMaxLoggersQuery` Valore: 19 Esegue una query sul numero massimo di sessioni di registrazione ETW attualmente configurate consentite dal sistema operativo. Restituisce un oggetto ULONG. Usato con EnumerateTraceGuidsEx. Il valore è supportato in Windows 10, versione 1709, Windows Server, versione 1709 e versioni successive.
`TraceLbrConfigurationInfo` Valore: 20 Abilita la traccia Last Branch Record per la sessione specificata e configura filtri LBR corrispondenti. Il valore è supportato in Windows 10 versione 19H1, Windows Server, versione 1903 e versioni successive.
`TraceLbrEventListInfo` Valore: 21 Configura l'elenco di eventi che attiveranno ETW per tracciare il record dell'ultimo ramo informazioni configurate da `TraceLbrConfigurationInfo`. Il valore è supportato in Windows 10 versione 19H1, Windows Server, versione 1903 e versioni successive.
`TraceMaxPmcCounterQuery` Valore: 22 Esegue una query sul numero massimo di origini di profilatura che possono essere contemporaneamente configurato per l'uso con ETW. Il valore è supportato in Windows 10 versione 19H1, Windows Server, versione 1903 e versioni successive.
`TraceStreamCount` Valore: 23 Esegue una query sul numero di flussi configurato per una sessione. Questo è di solito, ma non sempre, uguale al numero di processori nel sistema o 1 se no Il buffering per processore è configurato per la sessione. Il valore è supportato in Windows 10, versione 21H2, Windows Server 2022 e in un secondo momento.
`TraceStackCachingInfo` Valore: 24 Indica a ETW di iniziare a memorizzare nella cache le tracce dello stack per RegisterTraceGuids Eventi ("classici") in questa sessione. Il valore è supportato in Windows 10, versione 21H2, Windows Server 2022 e in un secondo momento.
`TracePmcCounterOwners` Valore: 25 Query ETW per un elenco dei contatori di monitoraggio delle prestazioni del processore attualmente in Utilizzare. Questo elenco può contenere contatori utilizzati da strutture diverse da ETW. Il valore è supportato in Windows 10, versione 21H2, Windows Server 2022 e in un secondo momento.
`TraceUnifiedStackCachingInfo` Valore: 26 Indica a ETW di iniziare a memorizzare nella cache le tracce dello stack sia per RegisterTraceGuids Eventi basati su EventRegister ("classic") e EventRegister. Il valore è supportato in Windows 10, versione 21H2, Windows Server 2022 e in un secondo momento.
`TracePmcSessionInformation` Valore: 27 Eseguire una query su tutte le sessioni per il set di configurazione pmC tramite `TracePmcEventListInfo` e `TracePmcCounterListInfo`. Il valore è supportato in Windows 10 versione 22H2 e successive.
`MaxTraceSetInfoClass` Valore: 28 Contrassegna l'ultimo valore nell'enumerazione . Non usare.

Commenti

Le enumerazioni TRACE_INFO_CLASS e TRACE_QUERY_INFO_CLASS definiscono entrambi gli stessi valori. Usare entrambe le enumerazioni con la funzione EnumerateTraceGuidsEx o la funzione TraceSetInformation .

Requisiti


Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Intestazione	evntrace.h

Vedi anche

EnumerateTraceGuidsEx

TraceSetInformation