Função ProcessTraceAddBufferToBufferStream (evntrace.h)

Artigo
07/19/2024

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 por 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
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

Compartilhar via