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

Статья
07/19/2024

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

Синтаксис

ETW_APP_DECLSPEC_DEPRECATED PROCESSTRACE_HANDLE WMIAPI OpenTraceFromRealTimeLogger(
  PCWSTR                       LoggerName,
  const ETW_OPEN_TRACE_OPTIONS *Options,
  TRACE_LOGFILE_HEADER         *LogFileHeader
);

Параметры

LoggerName

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

При вызове OpenTraceFromRealTimeLogger, если LogFileHeader неNULLLogerName необходимо NULL.

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

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

Options

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

LogFileHeader

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

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

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

Замечания

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Обновление 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

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