Función OpenTraceFromBufferStream (evntrace.h)

Crea una sesión de procesamiento de seguimiento que no está asociada directamente a ningún archivo o sesión activa.

Sintaxis

ETW_APP_DECLSPEC_DEPRECATED PROCESSTRACE_HANDLE WMIAPI OpenTraceFromBufferStream(
  const ETW_OPEN_TRACE_OPTIONS    *Options,
  PETW_BUFFER_COMPLETION_CALLBACK BufferCompletionCallback,
  void                            *BufferCompletionContext
);

Parámetros

Options

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

BufferCompletionCallback

Cuando la sesión de procesamiento se realiza con un búfer pasado desde ProcessTraceAddBufferToBufferStream, invocará esta devolución de llamada para permitir cualquier limpieza que pueda ser necesaria para ese búfer.

BufferCompletionContext

Contexto proporcionado por el usuario que se pasará al BufferCompletionCallback.

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

Se espera que el autor de la llamada proporcione los datos del seguimiento llamando a ProcessTraceAddBufferToBufferStream. Normalmente se usa para el procesamiento remoto de seguimientos en tiempo real: un sistema remoto usa OpenTraceFromRealTimeLogger y ProcessTrace con un BufferCallback que envía búferes a través de la red a un sistema local, a continuación, el sistema local llama openTraceFromBufferStream y ProcessTrace, recibe búferes de la red y los alimenta al procesador de seguimiento local mediante ProcessTraceAddBufferToBufferStream.

Este modo de procesamiento requiere que los búferes se proporcionen en el mismo orden en que se recibieron los búferes de ProcessTrace (por ejemplo, el primer búfer contiene información de encabezado y los búferes posteriores se ordenan por tiempo de vaciado). El único medio admitido para generar búferes de esta manera es desde el de BufferCallback de otra OpenTraceFromBufferStream, OpenTraceFromFile, OpenTraceFromRealTimeLogger, OpenTraceFromRealTimeLoggerWithAllocationOptions sesión de procesamiento.

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