Función ProcessTraceBufferIncrementReference (evntrace.h)

  • Artículo

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(
  TRACEHANDLE             TraceHandle,
  const ETW_BUFFER_HEADER *Buffer
);

Parámetros

TraceHandle

La 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 a la devolución de llamada PETW_BUFFER_CALLBACK.

Valor devuelto

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

Comentarios

Si no se llama a ProcessTraceBufferIncrementReference en un búfer durante el 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 haya terminado con él. ProcessTrace no devolverá hasta que esto se haya realizado 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

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado evntrace.h
Library Sechost.lib en Windows 8.1 y Windows Server 2012 R2; Advapi32.lib en Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista y Windows XP
Archivo DLL 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