PETW_BUFFER_CALLBACK funzione di callback (evntrace.h)

Definizione della funzione per BufferCallback che verrà richiamata da ProcessTrace.

Sintassi

PETW_BUFFER_CALLBACK PetwBufferCallback;

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

Parametri

Buffer

Puntatore ai dati del buffer non elaborati, che inizia con uno struct ETW_BUFFER_HEADER e viene seguito dai dati degli eventi.

Per impostazione predefinita, questo buffer è disponibile solo finché il callback non viene restituito. Per usare il buffer dopo il callback, chiamare ProcessTraceBufferIncrementReference. In questo modo il buffer verrà mantenuto fino a quando non si chiama ProcessTraceBufferDecrementReference .

ProcessTrace non restituirà fino a quando non sono stati decrementati tutti i riferimenti al buffer.

BufferSize

Dimensioni del buffer specificato.

ConsumerInfo

Contiene informazioni sullo stato corrente della sessione di elaborazione.

CallbackContext

Contesto fornito dall'utente da ETW_OPEN_TRACE_OPTIONS. BufferCallbackContext.

Valore restituito

Se TRUE, l'elaborazione continuerà. Se FALSE, l'elaborazione della traccia verrà arrestata e ProcessTrace restituirà.

Requisiti