Função ProcessTraceAddBufferToBufferStream (evntrace.h)

  • Artigo

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

Sintaxe

ETW_APP_DECLSPEC_DEPRECATED ULONG WMIAPI ProcessTraceAddBufferToBufferStream(
  TRACEHANDLE             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.

Retornar valor

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

Comentários

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