Función ProcessTraceBufferIncrementReference (evntrace.h)

Se llama durante el BufferCallback de 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

La sesión de procesamiento de la que procede este buffer.

Buffer

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

Valor devuelto

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

Observaciones

Si ProcessTraceBufferIncrementReference no se llama a en un búfer durante la PETW_BUFFER_CALLBACK, ya no se puede acceder a la memoria 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 se admite para los búferes proporcionados por una sesión de procesamiento abierta por OpenTraceFromBufferStream.

Requisitos

Requisito	Valor
cliente mínimo admitido	Actualización de Windows 11 2022
servidor mínimo admitido	Windows Server 2022
de la plataforma de destino de	Windows
encabezado de	evntrace.h
biblioteca de	Advapi32.dll
DLL de	Sechost.dll en Windows 8.1 y Windows Server 2012 R2; Advapi32.dll en Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista y Windows XP