ProcessTraceAddBufferToBufferStream-Funktion (evntrace.h)

Stellt einen ETW-Ablaufverfolgungspuffer für eine von OpenTraceFromBufferStream erstellte 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

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

Nach Abschluss der Verarbeitung des Puffers wird der in OpenTraceFromBufferStream angegebene BufferCompletionCallback aufgerufen, um ihn freizugeben.

Anforderungen