Funzione ProcessTraceBufferIncrementReference (evntrace.h)

Chiamato durante BufferCallback nel buffer fornito per evitare che venga liberato fino a quando il chiamante non viene completato con esso.

Sintassi

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

Parametri

TraceHandle

Sessione di elaborazione da cui proviene il buffer .

Buffer

Buffer a cui fare riferimento. Questo buffer deve essere stato ottenuto da una chiamata al callback PETW_BUFFER_CALLBACK .

Valore restituito

Codice errore Win32. I codici possibili possono includere ERROR_INVALID_PARAMETER e ERROR_OUTOFMEMORY.

Osservazioni

Se ProcessTraceBufferIncrementReference non viene chiamato in un buffer durante la PETW_BUFFER_CALLBACK , la memoria non è più accessibile dopo che il PETW_BUFFER_CALLBACK restituisce.

Il chiamante è responsabile della chiamata a ProcessTraceBufferDecrementReference nel buffer dopo averla completata. ProcessTrace non restituisce finché non viene eseguita questa operazione per ogni buffer incrementato.

ProcessTraceBufferIncrementReference non è supportato per i buffer forniti da una sessione di elaborazione aperta da OpenTraceFromBufferStream.

Fabbisogno

Requisito	Valore
Client minimo supportato	Aggiornamento di Windows 11 2022
Server minimo supportato	Windows Server 2022
Piattaforma di destinazione	Windows
Intestazione	evntrace.h
DLL	Sechost.dll su Windows 8.1 e Windows Server 2012 R2; Advapi32.dll su Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista e Windows XP