Função ProcessTraceBufferIncrementReference (evntrace.h)

Chamado durante o bufferCallback no buffer fornecido para evitar 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 terminarem. ProcessTrace não retornará até que isso tenha sido feito para cada buffer incrementado.

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

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Atualização do Windows 11 2022
servidor com suporte mínimo	Windows Server 2022
da Plataforma de Destino	Windows
cabeçalho	evntrace.h
biblioteca	Advapi32.dll
de DLL	Sechost.dll no Windows 8.1 e no Windows Server 2012 R2; Advapi32.dll no Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista e Windows XP