Fungsi ProcessTraceAddBufferToBufferStream (evntrace.h)

Artikel
07/19/2024

Menyediakan buffer jejak ETW ke sesi pemrosesan yang dibuat oleh OpenTraceFromBufferStream.

Sintaksis

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

Parameter

TraceHandle

TRACEHANDLE untuk sesi pemrosesan yang akan ditambahkan.

Buffer

Buffer ETW yang valid untuk diproses.

BufferSize

Ukuran buffer ETW.

Mengembalikan nilai

ERROR_SUCCESS atau kode kesalahan Win32 untuk menunjukkan bahwa buffer tidak valid, urutan kehabisan waktu, atau bahwa TraceHandle tidak valid.

Komentar

Buffer yang diteruskan oleh ProcessTraceAddBufferToBufferStream harus dalam urutan yang sama seperti yang diproduksi oleh ProcessTrace. Pengurutan buffer yang salah dapat menyebabkan fungsi mengembalikan kesalahan.

Ketika buffer selesai diproses, BufferCompletionCallback yang ditentukan dalam OpenTraceFromBufferStream akan dipanggil untuk merilisnya.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Pembaruan Windows 11 2022
server minimum yang didukung	Windows Server 2022
Platform Target	Windows
Header	evntrace.h
Pustaka	Advapi32.dll
DLL	Sechost.dll pada Windows 8.1 dan Windows Server 2012 R2; Advapi32.dll pada Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista dan Windows XP

Bagikan melalui