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 qualsiasi libertà o altra pulizia necessaria per tale buffer.

BufferCompletionContext

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

Valore restituito

TRACEHANDLE utilizzato per identificare questa sessione di elaborazione. In genere passato a ProcessTrace per iniziare l'elaborazione e a CloseTrace fino 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 bufferCallback che invia buffer in rete a un sistema locale, quindi il sistema locale chiama 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 all'ora di scaricamento). L'unico mezzo supportato per generare buffer in questo modo è da BufferCallback da un'altra sessione di elaborazione OpenTraceFromBufferStream, OpenTraceFromFile, OpenTraceFromRealTimeLogger, OpenTraceFromRealTimeLoggerWithAllocationOptions .

Fabbisogno