OpenTraceFromBufferStream-Funktion (evntrace.h)

Artikel
07/19/2024

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 erfolgt, der von ProcessTraceAddBufferToBufferStreamübergeben wird, wird dieser Rückruf aufgerufen, um eine kostenlose oder andere Bereinigung zu ermöglichen, die für diesen Puffer erforderlich sein kann.

BufferCompletionContext

Vom Benutzer bereitgestellter Kontext, der an die 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 CloseTrace- an die Verarbeitung zu beenden.

Bemerkungen

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

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 einem anderen OpenTraceFromBufferStream, OpenTraceFromFile, OpenTraceFromRealTimeLogger, OpenTraceFromRealTimeLoggerWithAllocationOptions Verarbeitungssitzung.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 11 2022 Update
mindestens unterstützte Server-	Windows Server 2022
Zielplattform-	Fenster
Header-	evntrace.h
Library	Advapi32.dll
DLL-	Sechost.dll unter Windows 8.1 und Windows Server 2012 R2; Advapi32.dll unter Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista und Windows XP

Freigeben über