Função OpenTraceFromBufferStream (evntrace.h)

Artigo
07/19/2024

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 PROCESSTRACE_HANDLE 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. Consulte ETW_OPEN_TRACE_OPTIONS para obter mais detalhes

BufferCompletionCallback

Quando a sessão de processamento for concluída com um buffer passado de ProcessTraceAddBufferToBufferStream, ele 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 de retorno

Um TRACEHANDLE usado para identificar essa sessão de processamento. Normalmente, passado para ProcessTrace para iniciar o processamento e CloseTrace para encerrar o processamento.

Observações

Espera-se que o chamador forneça os dados do 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, 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 requer que os buffers sejam fornecidos na mesma ordem em que os buffers foram recebidos de ProcessTrace (por exemplo, o primeiro buffer contém informações de cabeçalho e buffers subsequentes são ordenados por tempo de liberação). O único meio com suporte para gerar buffers dessa forma é do BufferCallback de outro OpenTraceFromBufferStream, OpenTraceFromFile, OpenTraceFromRealTimeLogger, OpenTraceFromRealTimeLoggerWithAllocationOptions sessão de processamento.

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