OpenTraceFromBufferStream-Funktion (evntrace.h)

Erstellt eine Ablaufverfolgungsverarbeitungssitzung, die nicht direkt an eine Datei oder aktive Sitzung angefügt ist.

Syntax

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

Parameter

Options

Konfigurationsoptionen für diese Verarbeitungssitzung. Weitere Informationen finden Sie unter ETW_OPEN_TRACE_OPTIONS

BufferCompletionCallback

Wenn die Verarbeitungssitzung mit einem puffer abgeschlossen wird, der von ProcessTraceAddBufferToBufferStream übergeben wird, wird dieser Rückruf aufgerufen, um alle Frei- oder andere Bereinigungen zuzulassen, die für diesen Puffer erforderlich sein können.

BufferCompletionContext

Vom Benutzer bereitgestellter Kontext, der an den BufferCompletionCallback übergeben wird.

Rückgabewert

Eine TRACEHANDLE, die verwendet wird, um diese Verarbeitungssitzung zu identifizieren. Wird in der Regel an ProcessTrace übergeben, um mit der Verarbeitung zu beginnen und die Verarbeitung zu beenden .

Bemerkungen

Der Aufrufer wird die Daten für die Ablaufverfolgung durch Aufrufen von ProcessTraceAddBufferToBufferStream bereitstellen. Dies wird in der Regel für die Remote-Echtzeitablaufverfolgungsverarbeitung verwendet: Ein Remotesystem verwendet OpenTraceFromRealTimeLogger und ProcessTrace mit einem BufferCallback , der Puffer über das Netzwerk an ein lokales System sendet. Anschließend ruft das lokale System OpenTraceFromBufferStream und ProcessTrace auf, empfängt Puffer aus dem Netzwerk und leitet sie mithilfe von ProcessTraceAddBufferToBufferStream an den lokalen Ablaufverfolgungsprozessor weiter.

Dieser Verarbeitungsmodus erfordert, dass die Puffer in derselben Reihenfolge bereitgestellt werden, in der die Puffer von ProcessTrace empfangen wurden (z. B. enthält der erste Puffer Kopfzeileninformationen und nachfolgende Puffer werden nach Leerlaufzeit sortiert). Die einzige unterstützte Möglichkeit zum Generieren von Puffern auf diese Weise stammt aus dem BufferCallback aus einer anderen OpenTraceFromBufferStream-, OpenTraceFromFile-, OpenTraceFromRealTimeLogger-, OpenTraceFromRealTimeLoggerWithAllocationOptions-Verarbeitungssitzung .

Anforderungen