Função ProcessTraceBufferIncrementReference (evntrace.h)

  • Artigo

Chamado durante o BufferCallback no Buffer fornecido para evitar que ele seja liberado até que o chamador seja concluído com ele.

Sintaxe

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

Parâmetros

TraceHandle

A sessão de processamento da qual esse Buffer veio.

Buffer

O buffer a ser referenciado. Esse buffer deve ter sido obtido por uma chamada para o retorno de chamada PETW_BUFFER_CALLBACK.

Retornar valor

Código de erro Win32. Os códigos possíveis podem incluir ERROR_INVALID_PARAMETER e ERROR_OUTOFMEMORY.

Comentários

Se ProcessTraceBufferIncrementReference não for chamado em um Buffer durante o PETW_BUFFER_CALLBACK , a memória não estará mais acessível após o retorno da PETW_BUFFER_CALLBACK .

O chamador é responsável por chamar ProcessTraceBufferDecrementReference no Buffer depois de terminar com ele. ProcessTrace não retornará até que isso tenha sido feito para cada buffer que foi incrementado.

ProcessTraceBufferIncrementReference não tem suporte para buffers fornecidos por uma sessão de processamento aberta por OpenTraceFromBufferStream.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho evntrace.h
Biblioteca Sechost.lib em Windows 8.1 e Windows Server 2012 R2; Advapi32.lib em Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista e Windows XP
DLL Sechost.dll em Windows 8.1 e Windows Server 2012 R2; Advapi32.dll em Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista e Windows XP