Función OpenTraceFromRealTimeLogger (evntrace.h)

Crea una sesión de procesamiento de seguimiento adjunta a una sesión ETW activa en tiempo real.

Sintaxis

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

Parámetros

LoggerName

Nombre de la sesión de seguimiento de eventos en tiempo real o NULL si procesa datos de un archivo de registro. Especifique un valor para este miembro si llama a OpenTraceFromRealTimeLogger para consumir datos de una sesión en tiempo real.

Al llamar a openTraceFromRealTimeLogger, si LogFileHeader no esNULL, LoggerName debe ser NULL.

Solo puede consumir eventos en tiempo real si el controlador de seguimiento ha establecido el LogFileMode miembro de EVENT_TRACE_PROPERTIES para incluir la marca de EVENT_TRACE_REAL_TIME_MODE.

Solo los usuarios con privilegios administrativos, los usuarios del grupo Usuarios del registro de rendimiento y las aplicaciones que se ejecutan como LocalSystem, LocalService, NetworkService pueden consumir eventos en tiempo real. Para conceder a un usuario restringido la capacidad de consumir eventos en tiempo real, agréguelos al grupo Usuarios del registro de rendimiento o llame a EventAccessControl.

Options

Opciones de configuración para esta sesión de procesamiento. Consulte ETW_OPEN_TRACE_OPTIONS para obtener más detalles.

LogFileHeader

Información de encabezado del archivo de registro. Consulte TRACE_LOGFILE_HEADER para obtener más información.

Valor devuelto

TRACEHANDLE que se usa para identificar esta sesión de procesamiento. Normalmente se pasa a processTrace para comenzar el procesamiento y CloseTrace al procesamiento final.

Observaciones

Una vez se llama a processTrace en el TRACEHANDLE devuelto, recibirá búferes de la sesión ETW a medida que se vacían y comienzan a procesarlos inmediatamente y llaman a las devoluciones de llamada especificadas en las opciones de .

Requisitos

Requisito	Valor
cliente mínimo admitido	Actualización de Windows 11 2022
servidor mínimo admitido	Windows Server 2022
de la plataforma de destino de	Windows
encabezado de	evntrace.h
biblioteca de	Advapi32.dll
DLL de	Sechost.dll en Windows 8.1 y Windows Server 2012 R2; Advapi32.dll en Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista y Windows XP