enumeración TRACE_QUERY_INFO_CLASS (evntrace.h)

  • Artículo

Se usa con EnumerateTraceGuidsEx, TraceQueryInformation o TraceSetInformation para especificar un tipo de información de seguimiento.

Tenga en cuenta que TRACE_INFO_CLASS y TRACE_QUERY_INFO_CLASS son definiciones de tipo para la misma enumeración.

Documentación más completa sobre qué API deben usarse los valores de la enumeración, así como los formatos de entrada y salida de búfer correspondientes están disponibles en línea en la TRACE_QUERY_INFO_CLASS definición de enumeración en 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
Valor: 0
Consulta de una matriz de GUID de los proveedores registrados en
equipo.
TraceGuidQueryInfo
Valor: 1
Consulte la información que cada sesión usa para habilitar el proveedor.
TraceGuidQueryProcess
Valor: 2
Consulta de una matriz de GUID de los proveedores que se han registrado en el
mismo proceso que el proceso de llamada.
TraceStackTracingInfo
Valor: 3
Consulte la configuración de seguimiento de pila de llamadas para eventos de kernel.

Devuelve una matriz de CLASSIC_EVENT_ID
Estructuras. Las estructuras especifican los GUID de eventos para los que se realiza el seguimiento de la pila.
habilitado. La matriz está limitada a 256 elementos.

El valor se admite en Windows 7, Windows Server 2008 R2 y versiones posteriores.
TraceSystemTraceEnableFlagsInfo
Valor: 4
Consulte la configuración de EnableFlags para el proveedor de seguimiento del sistema. Para
más información, consulte el
EVENT_TRACE_PROPERTIES estructura.

El valor se admite en Windows 8, Windows Server 2012 y versiones posteriores.
TraceSampledProfileIntervalInfo
Valor: 5
Consulta la configuración del intervalo de perfil de muestreo para el origen proporcionado.

El valor se admite en Windows 8, Windows Server 2012 y versiones posteriores.
TraceProfileSourceConfigInfo
Valor: 6
Configura la lista de orígenes de generación de perfiles que se recopilarán cuando
se activa el evento de perfil de contador de supervisión de rendimiento. Los contadores recopilados serán
se emite como parte del PERF_PMC_PROFILE evento.

El valor se admite en Windows 8, Windows Server 2012 y versiones posteriores.
TraceProfileSourceListInfo
Valor: 7
Consulta la lista de orígenes de generación de perfiles disponibles en el sistema.

El valor se admite en Windows 8, Windows Server 2012 y versiones posteriores.
TracePmcEventListInfo
Valor: 8
Configura la sesión con una lista de eventos del sistema para los que el rendimiento
Se recopilarán los contadores de supervisión configurados por TracePmcCounterListInfo .

El valor se admite en Windows 8, Windows Server 2012 y versiones posteriores.
TracePmcCounterListInfo
Valor: 9
Configura la sesión con una lista de orígenes de generación de perfiles que se recopilarán.
cuando los eventos configurados por TracePmcEventListInfo se registran en la sesión.

El valor se admite en Windows 8, Windows Server 2012 y versiones posteriores.
TraceSetDisallowList
Valor: 10
Establecer la lista de proveedores que no se habilitarán en esta sesión como parte de un
habilitación del grupo de proveedores. Para obtener más información, vea
Rasgos del proveedor.

El valor se admite en Windows 10, Windows Server 2016 y versiones posteriores.
TraceVersionInfo
Valor: 11
Consulte la información de la versión del archivo de seguimiento.

El valor se admite en Windows 10, Windows Server 2016 y versiones posteriores.
TraceGroupQueryList
Valor: 12
Consulte una matriz de GUID de los grupos de proveedores que están activos en el equipo.
TraceGroupQueryInfo
Valor: 13
El valor se admite en Windows 10, Windows Server 2016 y versiones posteriores.

Consulte la información que cada sesión usó para habilitar el grupo de proveedores.
TraceDisallowListQuery
Valor: 14
El valor se admite en Windows 10, Windows Server 2016 y versiones posteriores.

Consulte una matriz de GUID no permitidos para la habilitación de grupos en esta sesión.

El valor se admite en Windows 10, Windows Server 2016 y versiones posteriores.
TraceInfoReserved15
Reservado para uso futuro. No debe usarse.
TracePeriodicCaptureStateListInfo
Valor: 16
Actualiza la sesión con una lista de proveedores que recibirán periódicamente el
EVENT_CONTROL_CODE_CAPTURE_STATE código de control, similar a una llamada desde
EnableTraceEx2.

Para obtener más información, vea
TRACE_PERIODIC_CAPTURE_STATE_INFO.

El valor se admite en Windows 10, versión 1709, Windows Server, versión
1709 y versiones posteriores.
TracePeriodicCaptureStateInfo
Valor: 17
Consulta los límites de la configuración de estado de captura periódica en el sistema, incluido
la frecuencia de tiempo mínima y el número máximo de proveedores que pueden ser
configurado simultáneamente.

Para obtener más información, vea
TRACE_PERIODIC_CAPTURE_STATE_INFO.

El valor se admite en Windows 10, versión 1709, Windows Server, versión
1709 y versiones posteriores.
TraceProviderBinaryTracking
Valor: 18
Indica a ETW que comience a realizar el seguimiento de los archivos binarios de todos los proveedores habilitados para
la sesión. El seguimiento se aplica a los proveedores que están habilitados para la sesión.
en el momento de la llamada, así como a todos los proveedores futuros que están habilitados para
la sesión.

ETW genera eventos de seguimiento que contienen una asignación entre GUID de proveedor
y la ruta de acceso al módulo que contiene la devolución de llamada del proveedor con seguimiento. En
el caso de una sesión en tiempo real, los eventos se proporcionan en directo en tiempo real.
Búferes. En el caso de una sesión basada en archivos (es decir, si el seguimiento se guarda en un
Archivo .etl), los eventos se agregan y escriben en el encabezado de archivo; que harán
ser uno de los primeros eventos que proporciona el tiempo de ejecución de ETW cuando se reproduce el archivo .etl
Atrás.

Los eventos de seguimiento binario tendrán el identificador EventTraceGuid de proveedor y el código de operación.
0x43.

El valor se admite en Windows 10, versión 1709, Windows Server, versión
1709 y versiones posteriores.
TraceMaxLoggersQuery
Valor: 19
Consulta el número máximo configurado actualmente de sesiones de registro ETW permitidas
por el sistema operativo. Devuelve un ULONG. Se usa con
EnumerateTraceGuidsEx.

El valor se admite en Windows 10, versión 1709, Windows Server, versión
1709 y versiones posteriores.
TraceLbrConfigurationInfo
Valor: 20
Habilita el seguimiento del último registro de rama para la sesión especificada y configura
filtros LBR correspondientes.

El valor se admite en Windows 10, versión 19H1, Windows Server, versión
1903 y versiones posteriores.
TraceLbrEventListInfo
Valor: 21
Configura la lista de eventos que desencadenarán ETW para realizar un seguimiento del último registro de rama.
información configurada por TraceLbrConfigurationInfo.

El valor se admite en Windows 10, versión 19H1, Windows Server, versión
1903 y versiones posteriores.
TraceMaxPmcCounterQuery
Valor: 22
Consulta el número máximo de orígenes de generación de perfiles que pueden ser simultáneamente
configurado para su uso con ETW.

El valor se admite en Windows 10, versión 19H1, Windows Server, versión
1903 y versiones posteriores.
TraceStreamCount
Valor: 23
Consulta el recuento de flujos configurado para una sesión. Esto suele ser, pero no
siempre, igual al número de procesadores del sistema, o 1 si no
El almacenamiento en búfer por procesador está configurado para la sesión.

El valor es compatible con Windows 10, versión 21H2, Windows Server 2022 y
más adelante.
TraceStackCachingInfo
Valor: 24
Indica a ETW que comience a almacenar en caché los seguimientos de la pila para registerTraceGuids basado en
Eventos ("clásico") en esta sesión.

El valor es compatible con Windows 10, versión 21H2, Windows Server 2022 y
más adelante.
TracePmcCounterOwners
Valor: 25
Consulta ETW para obtener una lista de contadores de supervisión del rendimiento del procesador actualmente en
Uso. Esta lista puede contener contadores en uso por instalaciones distintas de ETW.

El valor es compatible con Windows 10, versión 21H2, Windows Server 2022 y
más adelante.
TraceUnifiedStackCachingInfo
Valor: 26
Indica a ETW que comience a almacenar en caché los seguimientos de la pila de registros basados en RegisterTraceGuids.
("Clásico") y eventos basados en EventRegister.

El valor es compatible con Windows 10, versión 21H2, Windows Server 2022 y
más adelante.
TracePmcSessionInformation
Valor: 27
Consulte todas las sesiones para su configuración de PMC establecida a través TracePmcEventListInfo de y TracePmcCounterListInfo.

El valor se admite en Windows 10, versión 22H2 y posteriores.
TraceContextRegisterInfo
Valor: 28
Configura la sesión con una lista de eventos del sistema para los que se registra el contexto.
se recopilarán eventos. Los eventos de registro de contexto contienen el registro de CPU
contenido en el momento en que se desencadena el evento relacionado especificado.

El valor se admite en Windows Server 23H2 y versiones posteriores.
MaxTraceSetInfoClass
Valor: 29
Marca el último valor de la enumeración. No debe usarse.

Comentarios

Las enumeraciones TRACE_INFO_CLASS y TRACE_QUERY_INFO_CLASS definen los mismos valores. Use ambas enumeraciones con la función EnumerateTraceGuidsEx o la función TraceSetInformation .

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Encabezado evntrace.h

Consulte también

EnumerateTraceGuidsEx

TraceSetInformation