структура ENABLE_TRACE_PARAMETERS_V1 (evntrace.h)
Структура ENABLE_TRACE_PARAMETERS_V1 содержит сведения, используемые для включения поставщика через EnableTraceEx2. Эта структура устарела. Вместо этого используйте ENABLE_TRACE_PARAMETERS .
Синтаксис
typedef struct _ENABLE_TRACE_PARAMETERS_V1 {
ULONG Version;
ULONG EnableProperty;
ULONG ControlFlags;
GUID SourceId;
PEVENT_FILTER_DESCRIPTOR EnableFilterDesc;
} ENABLE_TRACE_PARAMETERS_V1, *PENABLE_TRACE_PARAMETERS_V1;
Члены
Version
Задайте значение ENABLE_TRACE_PARAMETERS_VERSION (1).
EnableProperty
Необязательные сведения, которые может включать трассировка событий Windows при записи события. Данные записываются в раздел расширенного элемента данных события. Чтобы включить необязательные сведения, укажите один или несколько следующих флагов: в противном случае задайте нулевое значение.
EVENT_ENABLE_PROPERTY_SID
Включите в расширенные данные идентификатор безопасности (SID) пользователя.
EVENT_ENABLE_PROPERTY_TS_ID
Включите в расширенные данные идентификатор сеанса терминала.
EVENT_ENABLE_PROPERTY_STACK_TRACE
Добавьте трассировку стека вызовов в расширенные данные событий, записанных с помощью EventWrite.
Примечание
Трассировка событий Windows удаляет событие, если общий размер события превышает 64 КБ. Если поставщик регистрирует события, близкие к максимальному размеру 64 КБ, возможно, включение записи стека приведет к потере события.
Если размер стека превышает максимальное число кадров (192), кадры будут вырезаны из нижней части стека.
Для потребителей события будут включать EVENT_EXTENDED_ITEM_STACK_TRACE32 или EVENT_EXTENDED_ITEM_STACK_TRACE64 расширенный элемент. Обратите внимание, что 32-разрядные потребители могут получать 64-разрядные трассировки стека из 64-разрядных процессов.
ControlFlags
Зарезервировано. Задайте значение 0.
SourceId
GUID, однозначно определяющий вызывающий объект, который включает или отключает поставщик. Если поставщик не реализует EnableCallback, guid не используется.
EnableFilterDesc
Структура EVENT_FILTER_DESCRIPTOR , указывающая на данные фильтра. Поставщик использует данные фильтра, чтобы предотвратить запись в сеанс событий, соответствующих критериям фильтра. Поставщик определяет макет данных и способ применения фильтра к данным события. Сеанс может передать поставщику только один фильтр.
Сеанс может вызвать функцию TdhEnumerateProviderFilters , чтобы определить схематизированные фильтры, которые он может передать поставщику.
Комментарии
ENABLE_TRACE_PARAMETERS_V1 устарело. Структура ENABLE_TRACE_PARAMETERS является структурой версии 2 и заменяет структуру ENABLE_TRACE_PARAMETERS_V1 .
Как правило, на 64-разрядных компьютерах невозможно записать стек ядра в определенных контекстах, если ошибки страниц запрещены. Чтобы включить обход стека ядра в 64-разрядных средах, задайте DisablePagingExecutive для параметра Реестра Управление памятью значение 1. Значение DisablePagingExecutive реестра находится в следующем разделе реестра: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Memory Management.
Это следует делать только для временной диагностики, так как это увеличивает использование памяти системой.
Требования
| Минимальная версия клиента | Windows 7 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
| Верхняя часть | evntrace.h |