Función OpenTraceFromBufferStream (evntrace.h)

  • Artículo

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 TRACEHANDLE 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 realice con un búfer pasado desde ProcessTraceAddBufferToBufferStream, invocará esta devolución de llamada para permitir cualquier eliminación u otra limpieza que pueda ser necesaria para ese búfer.

BufferCompletionContext

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

Valor devuelto

TraceHANDLE que se usa para identificar esta sesión de procesamiento. Normalmente se pasa a ProcessTrace para comenzar el procesamiento y a CloseTrace para finalizar el procesamiento.

Comentarios

Se espera que el autor de la llamada proporcione los datos para el seguimiento mediante una llamada 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 y, a continuación, el sistema local llama a 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 la sesión de procesamiento BufferCallback desde otra sesión de procesamiento OpenTraceFromBufferStream, OpenTraceFromRealTimeLogger, OpenTraceFromRealTimeLoggerWithAllocationOptions.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado evntrace.h
Library Sechost.lib en Windows 8.1 y Windows Server 2012 R2; Advapi32.lib en Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista y Windows XP
Archivo DLL 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