перечисление TRACE_QUERY_INFO_CLASS (evntrace.h)
Используется с EnumerateTraceGuidsEx, TraceQueryInformation или TraceSetInformation для указания типа данных трассировки.
Обратите внимание, что TRACE_INFO_CLASS и TRACE_QUERY_INFO_CLASS являются определениями типов для одного перечисления.
Более подробная документация о том, с какими 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,
MaxTraceSetInfoClass = 28
} 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 и более поздних версиях. |
MaxTraceSetInfoClass Значение: 28 Помечает последнее значение в перечислении. Не используйте. |
Комментарии
Перечисления TRACE_INFO_CLASS и TRACE_QUERY_INFO_CLASS определяют одинаковые значения. Используйте оба перечисления с функцией EnumerateTraceGuidsEx или TraceSetInformation .
Требования
Минимальная версия клиента | Windows 7 [только классические приложения] |
Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
Верхняя часть | evntrace.h |
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по