PETW_BUFFER_CALLBACK función de devolución de llamada (evntrace.h)

  • Artículo

Definición de función para BufferCallback que ProcessTrace invocará.

Sintaxis

PETW_BUFFER_CALLBACK PetwBufferCallback;

BOOL PetwBufferCallback(
  const ETW_BUFFER_HEADER *Buffer,
  ULONG BufferSize,
  const ETW_BUFFER_CALLBACK_INFORMATION *ConsumerInfo,
  void *CallbackContext
)
{...}

Parámetros

Buffer

Puntero a los datos de búfer sin procesar, que comienzan con una estructura de ETW_BUFFER_HEADER y van seguidas de datos de eventos.

De forma predeterminada, este búfer solo está disponible hasta que la devolución de llamada vuelva. Para usar el búfer después de que se devuelva la devolución de llamada, llame a ProcessTraceBufferIncrementReference. Esto mantendrá el búfer disponible hasta que llame a ProcessTraceBufferDecrementReference en él.

ProcessTrace no devolverá hasta que se hayan reducido todas estas referencias de búfer.

BufferSize

Tamaño del búfer proporcionado.

ConsumerInfo

Contiene información sobre el estado actual de la sesión de procesamiento.

CallbackContext

Contexto proporcionado por el usuario de ETW_OPEN_TRACE_OPTIONS. BufferCallbackContext.

Valor devuelto

Si es TRUE, el procesamiento continuará. Si es FALSE, el procesamiento de seguimiento se detendrá y ProcessTrace devolverá.

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