Função ProcessTraceBufferIncrementReference (evntrace.h)

Chamado durante o BufferCallback no Buffer fornecido para impedir que ele seja liberado até que o chamador termine com ele.

Sintaxe

ETW_APP_DECLSPEC_DEPRECATED ULONG WMIAPI ProcessTraceBufferIncrementReference(
  PROCESSTRACE_HANDLE     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.

Valor de retorno

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

Observações

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 do PETW_BUFFER_CALLBACK .

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

Não há suporte para ProcessTraceBufferIncrementReference para buffers fornecidos por uma sessão de processamento aberta por OpenTraceFromBufferStream.

Requisitos

Requisito	Valor
Cliente mínimo suportado	Atualização do Windows 11 2022
Servidor mínimo compatível	Windows Server 2022
da Plataforma de Destino	Windows
Header	evntrace.h
de DLL	Sechost.dll no 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