Fungsi ProcessTraceBufferIncrementReference (evntrace.h)

Dipanggil selama BufferCallback pada Buffer yang disediakan untuk mencegahnya dikosongkan sampai pemanggil selesai dengannya.

Sintaks

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

Parameter

TraceHandle

Sesi pemrosesan asal Buffer ini.

Buffer

Buffer untuk referensi. Buffer ini harus diperoleh melalui panggilan ke panggilan balik PETW_BUFFER_CALLBACK .

Nilai kembali

Kode Kesalahan Win32. Kemungkinan kode dapat mencakup ERROR_INVALID_PARAMETER dan ERROR_OUTOFMEMORY.

Keterangan

Jika ProcessTraceBufferIncrementReference tidak dipanggil pada Buffer selama PETW_BUFFER_CALLBACK maka memori tidak lagi dapat diakses setelah PETW_BUFFER_CALLBACK kembali.

Pemanggil bertanggung jawab untuk memanggil ProcessTraceBufferDecrementReference pada Buffer setelah selesai dengannya. ProcessTrace tidak akan kembali sampai ini dilakukan untuk setiap buffer yang bertahap.

ProcessTraceBufferIncrementReference tidak didukung untuk buffer yang disediakan oleh sesi pemrosesan yang dibuka oleh OpenTraceFromBufferStream.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	evntrace.h
Pustaka	Sechost.lib di Windows 8.1 dan Windows Server 2012 R2; Advapi32.lib di Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista dan Windows XP
DLL	Sechost.dll di Windows 8.1 dan Windows Server 2012 R2; Advapi32.dll di Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista dan Windows XP