ProcessTraceAddBufferToBufferStream-Funktion (evntrace.h)

Artikel
07/19/2024

Stellt einen ETW-Ablaufverfolgungspuffer für eine Von OpenTraceFromBufferStreamerstellte Verarbeitungssitzung bereit.

Syntax

ETW_APP_DECLSPEC_DEPRECATED ULONG WMIAPI ProcessTraceAddBufferToBufferStream(
  PROCESSTRACE_HANDLE     TraceHandle,
  const ETW_BUFFER_HEADER *Buffer,
  ULONG                   BufferSize
);

Parameter

TraceHandle

Die TRACEHANDLE für die Verarbeitungssitzung, der hinzugefügt werden soll.

Buffer

Ein gültiger ETW-Puffer, der verarbeitet werden soll.

BufferSize

Die ETW-Puffergröße.

Rückgabewert

ERROR_SUCCESS oder ein Win32-Fehlercode, der angibt, dass der Puffer ungültig, außerhalb der Zeitreihenfolge ist oder dass die TraceHandle ungültig ist.

Bemerkungen

Puffer, die von ProcessTraceAddBufferToBufferStream übergeben werden, müssen in der gleichen Reihenfolge sein wie von ProcessTrace. Falsche Reihenfolge von Puffern kann dazu führen, dass die Funktion einen Fehler zurückgibt.

Nach Abschluss der Verarbeitung des Puffers wird die BufferCompletionCallback- aufgerufen, die in OpenTraceFromBufferStream- angegeben ist, um ihn freizugeben.

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