Funzione ProcessTraceBufferIncrementReference (evntrace.h)

Chiamato durante il BufferCallback nel buffer fornito per impedire 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 l'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 l' ProcessTraceBufferIncrementReference non viene chiamato in un buffer durante il PETW_BUFFER_CALLBACK, la memoria non è più accessibile al termine della PETW_BUFFER_CALLBACK.

Il chiamante è responsabile della chiamata di ProcessTraceBufferDecrementReference nel buffer dopo averlo completato. ProcessTrace non restituirà fino a quando non viene eseguita questa operazione per ogni buffer incrementato.

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

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 11 2022 Update
server minimo supportato	Windows Server 2022
piattaforma di destinazione	Finestre
intestazione	evntrace.h
libreria	Advapi32.dll
dll	Sechost.dll in Windows 8.1 e Windows Server 2012 R2; Advapi32.dll in Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista e Windows XP