Compartilhar via


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

Os consumidores de eventos ETW implementam essa função para receber estatísticas sobre cada buffer de eventos que o ETW fornece durante uma sessão de processamento de rastreamento. O ETW chama essa função depois que os eventos de cada buffer são entregues.

O tipo PEVENT_TRACE_BUFFER_CALLBACK define um ponteiro para essa função de retorno de chamada. BufferCallback é um espaço reservado para o nome da função definida pelo aplicativo.

Sintaxe

PEVENT_TRACE_BUFFER_CALLBACKA PeventTraceBufferCallbacka;

ULONG PeventTraceBufferCallbacka(
  PEVENT_TRACE_LOGFILEA Logfile
)
{...}

Parâmetros

Logfile

Ponteiro para uma estrutura EVENT_TRACE_LOGFILE que contém informações sobre o buffer.

Valor retornado

Para continuar processando eventos, retorne TRUE. Caso contrário, retorne FALSE. Retornar FALSE encerrará a função ProcessTrace .

Comentários

Para especificar a função que o ETW chama para fornecer as estatísticas de buffer, defina o membro BufferCallback da estrutura EVENT_TRACE_LOGFILE que você passa para a função OpenTrace .

Exemplos

Para obter um exemplo de implementação de uma função BufferCallback , consulte Recuperando dados de evento usando MOF.

Observação

O cabeçalho evntrace.h define PEVENT_TRACE_BUFFER_CALLBACK como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho evntrace.h

Confira também

EVENT_TRACE_LOGFILE

OpenTrace

ProcessTrace