Поделиться через

перечисление TRACE_QUERY_INFO_CLASS (evntrace.h)

  • Статья

Используется с EnumerateTraceGuidsEx, TraceQueryInformation или TraceSetInformation для указания типа данных трассировки.

Обратите внимание, что TRACE_INFO_CLASS и TRACE_QUERY_INFO_CLASS являются именами typedefs для одного перечисления.

Более подробная документация о том, с какими API-интерфейсами следует использовать значения перечисления, а также соответствующие форматы входных и выходных данных буфера доступны в определении TRACE_QUERY_INFO_CLASS перечисления в evntrace.h.

Синтаксис

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;

Константы

 
TraceGuidQueryList
Значение: 0
Запрос массива идентификаторов GUID поставщиков, зарегистрированных в
компьютере.
TraceGuidQueryInfo
Значение: 1
Запрос сведений, которые каждый сеанс использовал для включения поставщика.
TraceGuidQueryProcess
Значение: 2
Запрос массива идентификаторов GUID поставщиков, которые зарегистрировались в
тот же процесс, что и вызывающий процесс.
TraceStackTracingInfo
Значение: 3
Запросите параметр трассировки стека вызовов для событий ядра.

Возвращает массив CLASSIC_EVENT_ID
Структуры. Структуры определяют идентификаторы GUID событий, для которых трассировка стека
включено. Массив ограничен 256 элементами.

Значение поддерживается в Windows 7, Windows Server 2008 R2 и более поздних версиях.
TraceSystemTraceEnableFlagsInfo
Значение: 4
Запросите параметр EnableFlags для поставщика трассировки системы. Для
Дополнительные сведения см. в разделе
структура EVENT_TRACE_PROPERTIES .

Значение поддерживается в Windows 8, Windows Server 2012 и более поздних версиях.
TraceSampledProfileIntervalInfo
Значение: 5
Запрашивает параметр для интервала профиля выборки для предоставленного источника.

Значение поддерживается в Windows 8, Windows Server 2012 и более поздних версиях.
TraceProfileSourceConfigInfo
Значение: 6
Настраивает список источников профилирования, которые будут собираться при выполнении
срабатывает событие профиля счетчика мониторинга производительности. Собранные счетчики будут
будет выдано как часть PERF_PMC_PROFILE события.

Значение поддерживается в Windows 8, Windows Server 2012 и более поздних версиях.
TraceProfileSourceListInfo
Значение: 7
Запрашивает список источников профилирования, доступных в системе.

Значение поддерживается в Windows 8, Windows Server 2012 и более поздних версиях.
TracePmcEventListInfo
Значение: 8
Настраивает сеанс со списком системных событий, для которых производительность
будут собираться счетчики мониторинга, настроенные с помощью TracePmcCounterListInfo .

Значение поддерживается в Windows 8, Windows Server 2012 и более поздних версиях.
TracePmcCounterListInfo
Значение: 9
Настраивает сеанс со списком источников профилирования, которые будут собираться.
когда события, настроенные параметром , TracePmcEventListInfo регистрируются в сеансе.

Значение поддерживается в Windows 8, Windows Server 2012 и более поздних версиях.
TraceSetDisallowList
Значение: 10
Настройка списка поставщиков, которые не будут включены для этого сеанса в составе
включение группы поставщиков. Дополнительные сведения см. в разделе
Признаки поставщика.

Значение поддерживается в Windows 10, Windows Server 2016 и более поздних версиях.
TraceVersionInfo
Значение: 11
Запрос сведений о версии файла трассировки.

Значение поддерживается в Windows 10, Windows Server 2016 и более поздних версиях.
TraceGroupQueryList
Значение: 12
Запрос массива идентификаторов GUID групп поставщиков, которые активны на компьютере.
TraceGroupQueryInfo
Значение: 13
Значение поддерживается в Windows 10, Windows Server 2016 и более поздних версиях.

Запрос сведений, которые каждый сеанс использовал для включения группы поставщиков.
TraceDisallowListQuery
Значение: 14
Значение поддерживается в Windows 10, Windows Server 2016 и более поздних версиях.

Запрос массива идентификаторов GUID, которые запрещены для включения групп в этом сеансе.

Значение поддерживается в Windows 10, Windows Server 2016 и более поздних версиях.
TraceInfoReserved15
Зарезервировано для последующего использования. Не используйте.
TracePeriodicCaptureStateListInfo
Значение: 16
Обновляет сеанс со списком поставщиков, которые будут периодически получать
EVENT_CONTROL_CODE_CAPTURE_STATE код элемента управления, сродни вызову из
EnableTraceEx2.

Дополнительные сведения см. в разделе
TRACE_PERIODIC_CAPTURE_STATE_INFO.

Значение поддерживается в Windows 10 версии 1709, Windows Server, версия
1709 и более поздние версии.
TracePeriodicCaptureStateInfo
Значение: 17
Запрашивает ограничения параметров состояния периодической записи в системе, включая
минимальная частота времени и максимальное количество поставщиков, которые могут быть
одновременно настраивается.

Дополнительные сведения см. в разделе
TRACE_PERIODIC_CAPTURE_STATE_INFO.

Значение поддерживается в Windows 10 версии 1709, Windows Server, версия
1709 и более поздние версии.
TraceProviderBinaryTracking
Значение: 18
Указывает трассировке событий Windows начать отслеживание двоичных файлов для всех поставщиков, для которых разрешено
сеанс. Отслеживание применяется к поставщикам, которые включены в сеанс.
во время вызова, а также для всех будущих поставщиков, которым разрешено
сеанс.

Трассировка событий Windows создает события отслеживания, содержащие сопоставление между GUID поставщика
и путь к модулю, содержат обратный вызов для отслеживаемого поставщика. В
в случае сеанса в режиме реального времени события предоставляются в режиме реального времени
Буферов. В случае файлового сеанса (т. е. если трассировка сохраняется в
.etl file), события агрегируются и записываются в заголовок файла; они будут
быть одним из первых событий, которые предоставляет среда выполнения ETW при воспроизведении ETL-файла
Назад.

Двоичные события отслеживания будут иметь идентификатор EventTraceGuid поставщика и код операции.
0x43.

Значение поддерживается в Windows 10 версии 1709, Windows Server, версия
1709 и более поздние версии.
TraceMaxLoggersQuery
Значение: 19
Запрашивает настроено максимальное число сеансов ведения журнала ETW, разрешенных
операционной системой. Возвращает ULONG. Используется с
EnumerateTraceGuidsEx.

Значение поддерживается в Windows 10 версии 1709, Windows Server, версия
1709 и более поздние версии.
TraceLbrConfigurationInfo
Значение: 20
Включает трассировку записей последней ветви для заданного сеанса и настраивает
соответствующие фильтры LBR.

Значение поддерживается в Windows 10 версии 19H1, Windows Server, версия
1903, и более поздние.
TraceLbrEventListInfo
Значение: 21
Настраивает список событий, которые активируют трассировку записей последней ветви трассировки событий трассировки трассировки
сведения, настроенные с помощью TraceLbrConfigurationInfo.

Значение поддерживается в Windows 10 версии 19H1, Windows Server, версия
1903, и более поздние.
TraceMaxPmcCounterQuery
Значение: 22
Запрашивает максимальное количество источников профилирования, которые могут быть одновременно
настроено для использования с трассировкой событий Windows.

Значение поддерживается в Windows 10 версии 19H1, Windows Server, версия
1903, и более поздние.
TraceStreamCount
Значение: 23
Запрашивает настроенное число потоков для сеанса. Это обычно, но не
всегда равно количеству процессоров в системе или 1, если нет
Для сеанса настраивается буферизация на процессор.

Значение поддерживается в Windows 10 версии 21H2, Windows Server 2022 и
позже.
TraceStackCachingInfo
Значение: 24
Указывает etW начать кэширование трассировок стека для RegisterTraceGuids
События ("Классическая") в этом сеансе.

Значение поддерживается в Windows 10 версии 21H2, Windows Server 2022 и
позже.
TracePmcCounterOwners
Значение: 25
Запросы трассировки событий Windows для получения списка счетчиков мониторинга производительности процессора в настоящее время в
Использовать. В этом списке могут содержаться счетчики, используемые средствами, отличными от трассировки событий Windows.

Значение поддерживается в Windows 10 версии 21H2, Windows Server 2022 и
позже.
TraceUnifiedStackCachingInfo
Значение: 26
Указывает etW начать кэширование трассировок стека для обоих на основе RegisterTraceGuids
События ("Классическая") и EventRegister.

Значение поддерживается в Windows 10 версии 21H2, Windows Server 2022 и
позже.
TracePmcSessionInformation
Значение: 27
Запрос всех сеансов для набора конфигурации PMC с помощью TracePmcEventListInfo и TracePmcCounterListInfo.

Значение поддерживается в Windows 10 версии 22H2 и более поздних версиях.
TraceContextRegisterInfo
Значение: 28
Настраивает сеанс со списком системных событий, для которых регистрируется контекст.
будут собираться события. События регистра контекста содержат регистр ЦП
содержимое в момент запуска указанного связанного события.

Значение поддерживается в Windows Server 23H2 и более поздних версиях.
MaxTraceSetInfoClass
Значение: 29
Помечает последнее значение в перечислении. Не используйте.

Комментарии

Перечисления TRACE_INFO_CLASS и TRACE_QUERY_INFO_CLASS определяют одинаковые значения. Используйте оба перечисления с функцией EnumerateTraceGuidsEx или TraceSetInformation .

Требования

Требование Значение
Минимальная версия клиента Windows 7 [только классические приложения]
Минимальная версия сервера Windows Server 2008 R2 [только классические приложения]
Верхняя часть evntrace.h

См. также раздел

EnumerateTraceGuidsEx

TraceSetInformation