OpenTraceFromBufferStream-Funktion (evntrace.h)

  • Artikel

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

Syntax

ETW_APP_DECLSPEC_DEPRECATED TRACEHANDLE 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 ausgeführt wird, der von ProcessTraceAddBufferToBufferStream übergeben wird, ruft sie diesen Rückruf auf, um eine Freigabe oder andere Bereinigung zu ermöglichen, die möglicherweise für diesen Puffer erforderlich ist.

BufferCompletionContext

Vom Benutzer bereitgestellter Kontext, der an bufferCompletionCallback übergeben wird.

Rückgabewert

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

Hinweise

Es wird erwartet, dass der Aufrufer die Daten für die Ablaufverfolgung durch Aufruf von ProcessTraceAddBufferToBufferStream zur Verfügung stellt. Dies wird in der Regel für die Remoteverarbeitung der Ablaufverfolgung in Echtzeit 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 Headerinformationen, und nachfolgende Puffer werden nach Leerungszeit sortiert). Das einzige unterstützte Mittel zum Generieren von Puffern auf diese Weise ist das BufferCallback aus einer anderen Verarbeitungssitzung von OpenTraceFromBufferStream, OpenTraceFromFile, OpenTraceFromRealTimeLogger, OpenTraceFromRealTimeLoggerWithAllocationOptions .

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile evntrace.h
Bibliothek Sechost.lib unter Windows 8.1 und Windows Server 2012 R2; Advapi32.lib unter Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista und Windows XP
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