Funzione OpenTraceFromBufferStream (evntrace.h)

Crea una sessione di elaborazione della traccia che non è collegata direttamente a nessun file o sessione attiva.

Sintassi

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

Parametri

Options

Opzioni di configurazione per questa sessione di elaborazione. Per altri dettagli, vedere ETW_OPEN_TRACE_OPTIONS

BufferCompletionCallback

Quando la sessione di elaborazione viene eseguita con un buffer passato da ProcessTraceAddBufferToBufferStream, richiamerà questo callback per consentire la liberazione o altre operazioni di pulizia necessarie per tale buffer.

BufferCompletionContext

Contesto fornito dall'utente che verrà passato al BufferCompletionCallback.

Valore restituito

TRACEHANDLE utilizzato per identificare questa sessione di elaborazione. In genere passato a ProcessTrace per iniziare l'elaborazione e per CloseTrace alla fine dell'elaborazione.

Osservazioni

Il chiamante deve fornire i dati per la traccia chiamando ProcessTraceAddBufferToBufferStream. Viene in genere usato per l'elaborazione di traccia in tempo reale remoto: un sistema remoto usa OpenTraceFromRealTimeLogger e ProcessTrace con un BufferCallback che invia buffer in rete a un sistema locale, il sistema locale chiama quindi OpenTraceFromBufferStream e ProcessTrace, riceve i buffer dalla rete e li invia al processore di traccia locale usando ProcessTraceAddBufferToBufferStream.

Questa modalità di elaborazione richiede che i buffer vengano forniti nello stesso ordine in cui i buffer sono stati ricevuti da ProcessTrace (ad esempio, il primo buffer contiene informazioni sull'intestazione e i buffer successivi vengono ordinati in base al tempo di scaricamento). L'unico mezzo supportato per generare buffer in questo modo è dal BufferCallback da un altro OpenTraceFromBufferStream, OpenTraceFromFile, OpenTraceFromRealTimeLogger, OpenTraceFromRealTimeLoggerWithAllocationOptions sessione di elaborazione.

Fabbisogno