énumération TRACE_QUERY_INFO_CLASS (evntrace.h)

Article
06/12/2024

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

Partager via