Función ProcessTraceBufferIncrementReference (evntrace.h)

Se llama durante bufferCallback en el búfer proporcionado para evitar que se libere hasta que el autor de la llamada se realice con él.

Sintaxis

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

Parámetros

TraceHandle

Sesión de procesamiento de la que procede este búfer .

Buffer

Búfer al que se va a hacer referencia. Este búfer debe haberse obtenido mediante una llamada al PETW_BUFFER_CALLBACK devolución de llamada.

Valor devuelto

Código de error win32. Los códigos posibles pueden incluir ERROR_INVALID_PARAMETER y ERROR_OUTOFMEMORY.

Observaciones

Si no se llama a ProcessTraceBufferIncrementReference en un búfer durante la PETW_BUFFER_CALLBACK , la memoria ya no es accesible después de que se devuelva el PETW_BUFFER_CALLBACK .

El autor de la llamada es responsable de llamar a ProcessTraceBufferDecrementReference en el búfer una vez que hayan terminado con él. ProcessTrace no devolverá hasta que esto se haya hecho para cada búfer que se incrementó.

ProcessTraceBufferIncrementReference no es compatible con los búferes proporcionados por una sesión de procesamiento abierta por OpenTraceFromBufferStream.

Requisitos