Функция OpenTraceFromRealTimeLoggerWithAllocationOptions (evntrace.h)

Статья
07/19/2024

Создает сеанс обработки трассировки, подключенный к активному сеансу ETW в режиме реального времени.

Синтаксис

ETW_APP_DECLSPEC_DEPRECATED PROCESSTRACE_HANDLE WMIAPI OpenTraceFromRealTimeLoggerWithAllocationOptions(
  PCWSTR                       LoggerName,
  const ETW_OPEN_TRACE_OPTIONS *Options,
  ULONG_PTR                    AllocationSize,
  HANDLE                       MemoryPartitionHandle,
  TRACE_LOGFILE_HEADER         *LogFileHeader
);

Параметры

LoggerName

Имя сеанса трассировки событий в режиме реального времени или NULL при обработке данных из файла журнала. Укажите значение этого члена, если вы вызываете OpenTraceFromRealTimeLoggerWithAllocationOptions использовать данные из сеанса в режиме реального времени.

При вызове OpenTraceFromRealTimeLoggerWithAllocationOptions, если LogFileHeader неNULL LogerName должен быть NULL.

События можно использовать только в режиме реального времени, если контроллер трассировки задал элемент LogFileMode элемента EVENT_TRACE_PROPERTIES, чтобы включить флаг EVENT_TRACE_REAL_TIME_MODE.

Только пользователи с правами администратора, пользователи в группе "Пользователи журнала производительности" и приложения, работающие как LocalSystem, LocalService, NetworkService могут использовать события в режиме реального времени. Чтобы предоставить пользователю доступ к событиям в режиме реального времени, добавьте их в группу пользователей журнала производительности или вызовите EventAccessControl.

Options

Параметры конфигурации для этого сеанса обработки. Дополнительные сведения см. в ETW_OPEN_TRACE_OPTIONS.

AllocationSize

Размер памяти в байтах, которая будет предварительно выделена для хранения буферов ETW во время обработки. Более крупное выделение уменьшит потребность в отдельных вызовах и бесплатных вызовах за счет более высокого уровня согласованного использования памяти. Это будет скорректировано вверх до минимума общего буферного пространства базового Real-Time сеанса ETW, чтобы обеспечить достаточное количество выделено для базового функционирования. Если значение 0, будет использоваться размер по умолчанию.

MemoryPartitionHandle

Дескриптор секции памяти, который должен использоваться для выделения памяти для этого сеанса обработки. Если значение NULL, будет использоваться раздел памяти процесса. Дополнительные сведения см. в MemExtendedParameterPartitionHandle.

LogFileHeader

Сведения о заголовке файла журнала. Дополнительные сведения см. в TRACE_LOGFILE_HEADER.

Возвращаемое значение

TRACEHANDLE, используемый для идентификации этого сеанса обработки. Обычно передается в ProcessTrace, чтобы начать обработку и CloseTrace для завершения обработки.

Замечания

После вызова ProcessTrace для возвращаемого TRACEHANDLEэто будет получать буферы из сеанса ETW по мере их очистки и немедленного начала обработки и вызова обратных вызовов, указанных в параметрах. Это идентично OpenTraceFromRealTime, за исключением того, что он разрешает настройку выделения памяти для сеанса обработки.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Обновление Windows 11 2022
минимальный поддерживаемый сервер	Windows Server 2022
целевая платформа	Виндоус
заголовка	evntrace.h
библиотеки	Advapi32.dll
DLL	Sechost.dll в Windows 8.1 и Windows Server 2012 R2; Advapi32.dll в Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista и Windows XP

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