Partager via


énumération TRACE_QUERY_INFO_CLASS (evntrace.h)

Utilisé avec EnumerateTraceGuidsEx, TraceQueryInformation ou TraceSetInformation pour spécifier un type d’informations de trace.

Notez que TRACE_INFO_CLASS et TRACE_QUERY_INFO_CLASS sont des typedefs pour la même énumération.

Une documentation plus complète sur les API avec lesquelles les valeurs de l’énumération doivent être utilisées, ainsi que les formats d’entrée et de sortie de mémoire tampon correspondants sont disponibles en ligne dans la définition d’énumération TRACE_QUERY_INFO_CLASS dans evntrace.h.

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;

Constantes

 
TraceGuidQueryList
Valeur : 0
Recherchez un tableau de GUID des fournisseurs inscrits sur le
ordinateur.
TraceGuidQueryInfo
Valeur : 1
Interrogez les informations utilisées par chaque session pour activer le fournisseur.
TraceGuidQueryProcess
Valeur : 2
Recherchez un tableau de GUID des fournisseurs qui se sont inscrits dans le
même processus que le processus appelant.
TraceStackTracingInfo
Valeur : 3
Interrogez le paramètre pour le suivi de la pile des appels pour les événements du noyau.

Retourne un tableau de CLASSIC_EVENT_ID
Structures. Les structures spécifient les GUID d’événement pour lesquels le suivi de pile est
cochée. Le tableau est limité à 256 éléments.

La valeur est prise en charge sur Windows 7, Windows Server 2008 R2 et versions ultérieures.
TraceSystemTraceEnableFlagsInfo
Valeur : 4
Interrogez le paramètre enableflags pour le fournisseur de traces système. For
pour plus d’informations, consultez
EVENT_TRACE_PROPERTIES structure.

La valeur est prise en charge sur Windows 8, Windows Server 2012 et versions ultérieures.
TraceSampledProfileIntervalInfo
Valeur : 5
Interroge le paramètre pour l’intervalle de profil d’échantillonnage pour la source fournie.

La valeur est prise en charge sur Windows 8, Windows Server 2012 et versions ultérieures.
TraceProfileSourceConfigInfo
Valeur : 6
Configure la liste des sources de profilage qui seront collectées lorsque
l’événement de profil du compteur d’analyse des performances se déclenche. Les compteurs collectés seront
être émis dans le cadre de l’événement PERF_PMC_PROFILE .

La valeur est prise en charge sur Windows 8, Windows Server 2012 et versions ultérieures.
TraceProfileSourceListInfo
Valeur : 7
Interroge la liste des sources de profilage disponibles sur le système.

La valeur est prise en charge sur Windows 8, Windows Server 2012 et versions ultérieures.
TracePmcEventListInfo
Valeur : 8
Configure la session avec une liste d’événements système pour lesquels les performances
les compteurs de surveillance configurés par TracePmcCounterListInfo seront collectés.

La valeur est prise en charge sur Windows 8, Windows Server 2012 et versions ultérieures.
TracePmcCounterListInfo
Valeur : 9
Configure la session avec une liste des sources de profilage qui seront collectées
lorsque les événements configurés par TracePmcEventListInfo sont consignés dans la session.

La valeur est prise en charge sur Windows 8, Windows Server 2012 et versions ultérieures.
TraceSetDisallowList
Valeur : 10
Définir la liste des fournisseurs qui ne seront pas activés pour cette session dans le cadre d’une
activation du groupe de fournisseurs. Pour plus d'informations, consultez la rubrique
Caractéristiques du fournisseur.

La valeur est prise en charge sur Windows 10, Windows Server 2016 et versions ultérieures.
TraceVersionInfo
Valeur : 11
Interrogez les informations de version du fichier de trace.

La valeur est prise en charge sur Windows 10, Windows Server 2016 et versions ultérieures.
TraceGroupQueryList
Valeur : 12
Interrogez un tableau de GUID des groupes de fournisseurs actifs sur l’ordinateur.
TraceGroupQueryInfo
Valeur : 13
La valeur est prise en charge sur Windows 10, Windows Server 2016 et versions ultérieures.

Interroger les informations utilisées par chaque session pour activer le groupe de fournisseurs.
TraceDisallowListQuery
Valeur : 14
La valeur est prise en charge sur Windows 10, Windows Server 2016 et versions ultérieures.

Interrogez un tableau de GUID qui ne sont pas autorisés pour les activations de groupe sur cette session.

La valeur est prise en charge sur Windows 10, Windows Server 2016 et versions ultérieures.
TraceInfoReserved15
Réservé pour un usage futur. Ne pas utiliser.
TracePeriodicCaptureStateListInfo
Valeur : 16
Met à jour la session avec une liste de fournisseurs qui recevront régulièrement le
EVENT_CONTROL_CODE_CAPTURE_STATE code de contrôle, semblable à un appel de
EnableTraceEx2.

Pour plus d'informations, consultez la rubrique
TRACE_PERIODIC_CAPTURE_STATE_INFO.

La valeur est prise en charge sur Windows 10, version 1709, Windows Server, version
1709 et versions ultérieures.
TracePeriodicCaptureStateInfo
Valeur : 17
Interroge les limites des paramètres d’état de capture périodique sur le système, notamment
la fréquence de temps minimale et le nombre maximal de fournisseurs pouvant être
configuré simultanément.

Pour plus d'informations, consultez la rubrique
TRACE_PERIODIC_CAPTURE_STATE_INFO.

La valeur est prise en charge sur Windows 10, version 1709, Windows Server, version
1709 et versions ultérieures.
TraceProviderBinaryTracking
Valeur : 18
Indique à ETW de commencer le suivi des fichiers binaires pour tous les fournisseurs activés pour
la session. Le suivi s’applique aux fournisseurs activés pour la session
au moment de l’appel, ainsi qu’à tous les futurs fournisseurs qui sont activés pour
la session.

ETW génère des événements de suivi qui contiennent un mappage entre le ou les GUID du fournisseur
et le chemin d’accès au module contenant le rappel pour le fournisseur suivi. Dans
le cas d’une session en temps réel, les événements sont fournis en direct en temps réel
Tampons. Dans le cas d’une session basée sur un fichier (c’est-à-dire si la trace est enregistrée dans un
fichier .etl), les événements sont agrégés et écrits dans l’en-tête de fichier ; ils vont
être parmi les premiers événements que le runtime ETW fournit lors de la lecture du fichier .etl
Précédent.

Les événements de suivi binaires auront un ID de EventTraceGuid fournisseur et un opcode
0x43.

La valeur est prise en charge sur Windows 10, version 1709, Windows Server, version
1709 et versions ultérieures.
TraceMaxLoggersQuery
Valeur : 19
Interroge le nombre maximal actuellement configuré de sessions de journalisation ETW autorisées
par le système d’exploitation. Retourne un ULONG. Utilisé avec
EnumerateTraceGuidsEx.

La valeur est prise en charge sur Windows 10, version 1709, Windows Server, version
1709 et versions ultérieures.
TraceLbrConfigurationInfo
Valeur : 20
Active le suivi de l’enregistrement Last Branch pour la session donnée et configure
filtres LBR correspondants.

La valeur est prise en charge sur Windows 10, version 19H1, Windows Server, version
1903, et versions ultérieures.
TraceLbrEventListInfo
Valeur : 21
Configure la liste des événements qui déclencheront ETW pour effectuer le suivi de l’enregistrement Last Branch
informations configurées par TraceLbrConfigurationInfo.

La valeur est prise en charge sur Windows 10, version 19H1, Windows Server, version
1903, et versions ultérieures.
TraceMaxPmcCounterQuery
Valeur : 22
Interroge le nombre maximal de sources de profilage qui peuvent être simultanément
configuré pour une utilisation avec ETW.

La valeur est prise en charge sur Windows 10, version 19H1, Windows Server, version
1903, et versions ultérieures.
TraceStreamCount
Valeur : 23
Interroge le nombre de flux configuré pour une session. C’est généralement, mais pas
toujours, égal au nombre de processeurs sur le système, ou 1 si aucun
La mise en mémoire tampon par processeur est configurée pour la session.

La valeur est prise en charge sur Windows 10, version 21H2, Windows Server 2022 et
ultérieurement.
TraceStackCachingInfo
Valeur : 24
Demande à ETW de commencer la mise en cache des traces de pile pour RegisterTraceGuids
Événements (« classiques ») dans cette session.

La valeur est prise en charge sur Windows 10, version 21H2, Windows Server 2022 et
ultérieurement.
TracePmcCounterOwners
Valeur : 25
Interroge ETW pour obtenir la liste des compteurs d’analyse des performances du processeur actuellement dans
Utiliser. Cette liste peut contenir des compteurs utilisés par des installations autres que ETW.

La valeur est prise en charge sur Windows 10, version 21H2, Windows Server 2022 et
ultérieurement.
TraceUnifiedStackCachingInfo
Valeur : 26
Demande à ETW de commencer la mise en cache des traces de pile pour les deux basées sur RegisterTraceGuids
Événements (« Classiques ») et Basés sur EventRegister.

La valeur est prise en charge sur Windows 10, version 21H2, Windows Server 2022 et
ultérieurement.
TracePmcSessionInformation
Valeur : 27
Interrogez toutes les sessions pour leur configuration PMC définie via TracePmcEventListInfo et TracePmcCounterListInfo.

La valeur est prise en charge sur Windows 10, version 22H2 et ultérieure.
TraceContextRegisterInfo
Valeur : 28
Configure la session avec une liste d’événements système pour lesquels l’enregistrement de contexte
les événements seront collectés. Les événements de registre de contexte contiennent le registre du processeur
au moment où l’événement associé spécifié est déclenché.

La valeur est prise en charge sur Windows Server 23H2 et versions ultérieures.
MaxTraceSetInfoClass
Valeur : 29
Marque la dernière valeur de l’énumération. Ne pas utiliser.

Remarques

Les énumérations TRACE_INFO_CLASS et TRACE_QUERY_INFO_CLASS définissent les mêmes valeurs. Utilisez les deux énumérations avec la fonction EnumerateTraceGuidsEx ou la fonction TraceSetInformation .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
En-tête evntrace.h

Voir aussi

EnumerateTraceGuidsEx

TraceSetInformation