Função OpenTraceFromBufferStream (evntrace.h)

  • Artigo

Cria uma sessão de processamento de rastreamento que não está diretamente anexada a nenhum arquivo ou sessão ativa.

Sintaxe

ETW_APP_DECLSPEC_DEPRECATED TRACEHANDLE WMIAPI OpenTraceFromBufferStream(
  const ETW_OPEN_TRACE_OPTIONS    *Options,
  PETW_BUFFER_COMPLETION_CALLBACK BufferCompletionCallback,
  void                            *BufferCompletionContext
);

Parâmetros

Options

Opções de configuração para esta sessão de processamento. Confira ETW_OPEN_TRACE_OPTIONS para obter mais detalhes

BufferCompletionCallback

Quando a sessão de processamento for feita com um buffer passado de ProcessTraceAddBufferToBufferStream, ela invocará esse retorno de chamada para permitir qualquer liberação ou outra limpeza que possa ser necessária para esse buffer.

BufferCompletionContext

Contexto fornecido pelo usuário que será passado para o BufferCompletionCallback.

Valor retornado

Um TRACEHANDLE que é usado para identificar essa sessão de processamento. Normalmente passado para ProcessTrace para começar o processamento e para CloseTrace para encerrar o processamento.

Comentários

Espera-se que o chamador forneça os dados para o rastreamento chamando ProcessTraceAddBufferToBufferStream. Normalmente, isso é usado para processamento remoto de rastreamento em tempo real: um sistema remoto usa OpenTraceFromRealTimeLogger e ProcessTrace com um BufferCallback que envia buffers pela rede para um sistema local e, em seguida, o sistema local chama OpenTraceFromBufferStream e ProcessTrace, recebe buffers da rede e os alimenta para o processador de rastreamento local usando ProcessTraceAddBufferToBufferStream.

Esse modo de processamento exige que os buffers sejam fornecidos na mesma ordem em que os buffers foram recebidos do ProcessTrace (por exemplo, o primeiro buffer contém informações de cabeçalho e buffers subsequentes são ordenados pelo tempo de liberação). O único meio com suporte para gerar buffers dessa forma é do BufferCallback de outra sessão de processamento OpenTraceFromBufferStream, OpenTraceFromFile, OpenTraceFromRealTimeLogger, OpenTraceFromRealTimeLoggerWithAllocationOptions .

Requisitos

   
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 no 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 no Windows 8, Windows Server 2012, Windows 7, Windows Server 2008 R2, Windows Server 2008, Windows Vista e Windows XP