PETW_BUFFER_CALLBACK função de retorno de chamada (evntrace.h)

Artigo
08/23/2023

Definição de função para o BufferCallback que será invocado pelo ProcessTrace.

Sintaxe

PETW_BUFFER_CALLBACK PetwBufferCallback;

BOOL PetwBufferCallback(
  const ETW_BUFFER_HEADER *Buffer,
  ULONG BufferSize,
  const ETW_BUFFER_CALLBACK_INFORMATION *ConsumerInfo,
  void *CallbackContext
)
{...}

Parâmetros

Buffer

Ponteiro para os dados brutos do buffer, que começa com um struct ETW_BUFFER_HEADER e é seguido por dados de evento.

Por padrão, esse buffer só estará disponível até que o retorno de chamada retorne. Para usar o buffer depois que o retorno de chamada retornar, chame ProcessTraceBufferIncrementReference. Isso manterá o buffer disponível até que você chame ProcessTraceBufferDecrementReference nele.

ProcessTrace não retornará até que todas essas referências de buffer tenham sido decrementada.

BufferSize

Tamanho do Buffer fornecido.

ConsumerInfo

Contém informações sobre o estado atual da sessão de processamento.

CallbackContext

Contexto fornecido pelo usuário de ETW_OPEN_TRACE_OPTIONS. BufferCallbackContext.

Valor retornado

Se TRUE, o processamento continuará. Se FALSE, o processamento de rastreamento será interrompido e ProcessTrace retornará.

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 no Windows 8.1 e no 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 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