ProcessTraceAddBufferToBufferStream-Funktion (evntrace.h)

  • Artikel

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

Syntax

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

Parameter

TraceHandle

Das 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 einen Win32-Fehlercode, um anzugeben, dass der Puffer ungültig ist, dass die Zeitreihenfolge nicht vorhanden ist oder dass traceHandle ungültig ist.

Hinweise

Puffer, die von ProcessTraceAddBufferToBufferStream übergeben werden, müssen sich in derselben Reihenfolge befinden, in der sie von ProcessTrace erstellt wurden. Eine falsche Reihenfolge der Puffer kann dazu führen, dass die Funktion einen Fehler zurückgibt.

Wenn die Verarbeitung des Puffers abgeschlossen ist, wird das in OpenTraceFromBufferStream angegebene BufferCompletionCallback aufgerufen, um ihn freizugeben.

Anforderungen

Anforderung Wert
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 auf 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 auf 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