Função ProcessTraceAddBufferToBufferStream (evntrace.h)

Fornece um buffer de rastreamento ETW para uma sessão de processamento criada por OpenTraceFromBufferStream.

Sintaxe

ETW_APP_DECLSPEC_DEPRECATED ULONG WMIAPI ProcessTraceAddBufferToBufferStream(
  PROCESSTRACE_HANDLE     TraceHandle,
  const ETW_BUFFER_HEADER *Buffer,
  ULONG                   BufferSize
);

Parâmetros

TraceHandle

O TRACEHANDLE para a sessão de processamento a ser adicionada.

Buffer

Um buffer ETW válido a ser processado.

BufferSize

O tamanho do buffer ETW.

Valor de retorno

ERROR_SUCCESS ou um código de erro Win32 para indicar que o buffer é inválido, a ordem fora do tempo ou que o TraceHandle é inválido.

Observações

Os buffers passados por ProcessTraceAddBufferToBufferStream devem estar na mesma ordem em que foram produzidos pelo ProcessTrace. A ordenação incorreta de buffers pode fazer com que a função retorne um erro.

Quando o buffer terminar de processar, o BufferCompletionCallback especificado em OpenTraceFromBufferStream será chamado para liberá-lo.

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