Funzione OpenTraceFromBufferStream (evntrace.h)

Articolo
07/19/2024

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

Requisito	Valore
client minimo supportato	Windows 11 2022 Update
server minimo supportato	Windows Server 2022
piattaforma di destinazione	Finestre
intestazione	evntrace.h
libreria	Advapi32.dll
dll	Sechost.dll in Windows 8.1 e Windows Server 2012 R2; Advapi32.dll in Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista e Windows XP

Condividi tramite