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