TRACE_QUERY_INFO_CLASS enumeração (evntrace.h)

  • Artigo

Usado com EnumerateTraceGuidsEx, TraceQueryInformation ou TraceSetInformation para especificar um tipo de informação de rastreamento.

Observe que TRACE_INFO_CLASS e TRACE_QUERY_INFO_CLASS são typedefs para a mesma enumeração.

Documentação mais abrangente sobre quais APIs os valores na enumeração devem ser usados, bem como os formatos de entrada e saída de buffer correspondentes estão disponíveis em linha na TRACE_QUERY_INFO_CLASS definição de enumeração em 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
Consultar uma matriz de GUIDs dos provedores registrados no
Computador.
TraceGuidQueryInfo
Valor: 1
Consulte informações que cada sessão usou para habilitar o provedor.
TraceGuidQueryProcess
Valor: 2
Consultar uma matriz de GUIDs dos provedores que se registraram no
mesmo processo que o processo de chamada.
TraceStackTracingInfo
Valor: 3
Consulte a configuração de rastreamento de pilha de chamadas para eventos de kernel.

Retorna uma matriz de CLASSIC_EVENT_ID
Estruturas. As estruturas especificam os GUIDs de evento para os quais o rastreamento de pilha é
habilitada. A matriz é limitada a 256 elementos.

O valor tem suporte no Windows 7, Windows Server 2008 R2 e posterior.
TraceSystemTraceEnableFlagsInfo
Valor: 4
Consulte a configuração de EnableFlags para o provedor de rastreamento do sistema. For (para)
mais informações, consulte o
EVENT_TRACE_PROPERTIES estrutura.

O valor tem suporte no Windows 8, Windows Server 2012 e posterior.
TraceSampledProfileIntervalInfo
Valor: 5
Consulta a configuração do intervalo de perfil de amostragem para a origem fornecida.

O valor tem suporte no Windows 8, Windows Server 2012 e posterior.
TraceProfileSourceConfigInfo
Valor: 6
Configura a lista de fontes de criação de perfil que serão coletadas quando o
evento de perfil do contador de monitoramento de desempenho é acionado. Os contadores coletados serão
ser emitido como parte do PERF_PMC_PROFILE evento.

O valor tem suporte no Windows 8, Windows Server 2012 e posterior.
TraceProfileSourceListInfo
Valor: 7
Consulta a lista de fontes de criação de perfil disponíveis no sistema.

O valor tem suporte no Windows 8, Windows Server 2012 e posterior.
TracePmcEventListInfo
Valor: 8
Configura a sessão com uma lista de eventos do sistema para os quais o desempenho
os contadores de monitoramento configurados por TracePmcCounterListInfo serão coletados.

O valor tem suporte no Windows 8, Windows Server 2012 e posterior.
TracePmcCounterListInfo
Valor: 9
Configura a sessão com uma lista de fontes de criação de perfil que serão coletadas
quando os eventos configurados por TracePmcEventListInfo são registrados na sessão.

O valor tem suporte no Windows 8, Windows Server 2012 e posterior.
TraceSetDisallowList
Valor: 10
Definir a lista de provedores que não serão habilitados para esta sessão como parte de um
habilitação do grupo de provedores. Para obter mais informações, consulte
Características do provedor.

O valor tem suporte no Windows 10, Windows Server 2016 e posterior.
TraceVersionInfo
Valor: 11
Consulte as informações de versão do arquivo de rastreamento.

O valor tem suporte no Windows 10, Windows Server 2016 e posterior.
TraceGroupQueryList
Valor: 12
Consulte uma matriz de GUIDs dos grupos de provedores que estão ativos no computador.
TraceGroupQueryInfo
Valor: 13
O valor tem suporte no Windows 10, Windows Server 2016 e posterior.

Consultar informações que cada sessão usou para habilitar o grupo de provedores.
TraceDisallowListQuery
Valor: 14
O valor tem suporte no Windows 10, Windows Server 2016 e posterior.

Consulte uma matriz de GUIDs que não são permitidos para habilitações de grupo nesta sessão.

O valor tem suporte no Windows 10, Windows Server 2016 e posterior.
TraceInfoReserved15
Reservado para uso futuro. Não use.
TracePeriodicCaptureStateListInfo
Valor: 16
Atualiza a sessão com uma lista de provedores que receberão periodicamente o
EVENT_CONTROL_CODE_CAPTURE_STATE código de controle, semelhante a uma chamada de
EnableTraceEx2.

Para obter mais informações, consulte
TRACE_PERIODIC_CAPTURE_STATE_INFO.

O valor tem suporte no Windows 10, versão 1709, Windows Server, versão
1709, e posterior.
TracePeriodicCaptureStateInfo
Valor: 17
Consulta os limites das configurações de estado de captura periódica no sistema, incluindo
a frequência mínima de tempo e o número máximo de provedores que podem ser
configurado simultaneamente.

Para obter mais informações, consulte
TRACE_PERIODIC_CAPTURE_STATE_INFO.

O valor tem suporte no Windows 10, versão 1709, Windows Server, versão
1709, e posterior.
TraceProviderBinaryTracking
Valor: 18
Instrui o ETW a começar a rastrear binários para todos os provedores habilitados para
a sessão. O acompanhamento se aplica a provedores habilitados para a sessão
no momento da chamada, bem como para todos os provedores futuros que estão habilitados para
a sessão.

O ETW gera eventos de acompanhamento que contêm um mapeamento entre GUID(s) do provedor
e o caminho para o módulo que contém o retorno de chamada para o provedor rastreado. Em
o caso de uma sessão em tempo real, os eventos são fornecidos ao vivo em tempo real
Buffers. No caso de uma sessão baseada em arquivo (ou seja, se o rastreamento for salvo em um
Arquivo .etl), os eventos são agregados e gravados no cabeçalho do arquivo; eles vão
estar entre os primeiros eventos que o runtime do ETW fornece quando o arquivo .etl é reproduzido
Voltar.

Os eventos de acompanhamento binário terão id EventTraceGuid do provedor e opcode
0x43.

O valor tem suporte no Windows 10, versão 1709, Windows Server, versão
1709, e posterior.
TraceMaxLoggersQuery
Valor: 19
Consulta o número máximo atualmente configurado de sessões de log etw permitidas
pelo sistema operacional. Retorna um ULONG. Usada com
EnumerateTraceGuidsEx.

O valor tem suporte no Windows 10, versão 1709, Windows Server, versão
1709, e posterior.
TraceLbrConfigurationInfo
Valor: 20
Habilita o rastreamento de Registro do Último Branch para a sessão especificada e configura
filtros LBR correspondentes.

O valor tem suporte no Windows 10, versão 19H1, Windows Server, versão
1903, e posterior.
TraceLbrEventListInfo
Valor: 21
Configura a lista de eventos que dispararão o ETW para rastrear o Último Registro de Branch
informações conforme configurado por TraceLbrConfigurationInfo.

O valor tem suporte no Windows 10, versão 19H1, Windows Server, versão
1903, e posterior.
TraceMaxPmcCounterQuery
Valor: 22
Consulta o número máximo de fontes de criação de perfil que podem ser simultaneamente
configurado para uso com ETW.

O valor tem suporte no Windows 10, versão 19H1, Windows Server, versão
1903, e posterior.
TraceStreamCount
Valor: 23
Consulta a contagem de fluxo configurada para uma sessão. Isso geralmente é, mas não
sempre, igual ao número de processadores no sistema, ou 1, se não
O buffer por processador está configurado para a sessão.

O valor tem suporte no Windows 10, versão 21H2, Windows Server 2022 e
mais tarde.
TraceStackCachingInfo
Valor: 24
Instrui o ETW a iniciar o cache de rastreamentos de pilha para RegisterTraceGuids baseados em
("Clássico") eventos nesta sessão.

O valor tem suporte no Windows 10, versão 21H2, Windows Server 2022 e
mais tarde.
TracePmcCounterOwners
Valor: 25
Consulta o ETW para obter uma lista de contadores de monitoramento de desempenho do processador atualmente em
Usar. Essa lista pode conter contadores em uso por instalações diferentes do ETW.

O valor tem suporte no Windows 10, versão 21H2, Windows Server 2022 e
mais tarde.
TraceUnifiedStackCachingInfo
Valor: 26
Instrui o ETW a iniciar o cache de rastreamentos de pilha para ambos os rastreamentos de pilha baseados em RegisterTraceGuids
("Clássico") e eventos baseados em EventRegister.

O valor tem suporte no Windows 10, versão 21H2, Windows Server 2022 e
mais tarde.
TracePmcSessionInformation
Valor: 27
Consulte todas as sessões para o conjunto de configuração do PMC por meio de TracePmcEventListInfo e TracePmcCounterListInfo.

O valor tem suporte no Windows 10, versão 22H2 e posterior.
TraceContextRegisterInfo
Valor: 28
Configura a sessão com uma lista de eventos do sistema para os quais o registro de contexto
eventos serão coletados. Eventos de registro de contexto contêm registro de CPU
no momento em que o evento relacionado especificado é acionado.

O valor tem suporte no Windows Server 23H2 e posterior.
MaxTraceSetInfoClass
Valor: 29
Marca o último valor na enumeração . Não use.

Comentários

As enumerações TRACE_INFO_CLASS e TRACE_QUERY_INFO_CLASS definem os mesmos valores. Use as duas enumerações com a função EnumerateTraceGuidsEx ou a função TraceSetInformation .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Cabeçalho evntrace.h

Confira também

EnumerateTraceGuidsEx

TraceSetInformation