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 |