Compartilhar via


estrutura ETW_OPEN_TRACE_OPTIONS (evntrace.h)

Fornece parâmetros de configuração para as funções OpenTraceFromBufferStream, OpenTraceFromFile, OpenTraceFromRealTimeLogger, OpenTraceFromRealTimeLoggerWithAllocationOptions .

Sintaxe

typedef struct ETW_OPEN_TRACE_OPTIONS {
  ETW_PROCESS_TRACE_MODES ProcessTraceModes;
  PEVENT_RECORD_CALLBACK  EventCallback;
  void                    *EventCallbackContext;
  PETW_BUFFER_CALLBACK    BufferCallback;
  void                    *BufferCallbackContext;
} ETW_OPEN_TRACE_OPTIONS;

Membros

ProcessTraceModes

Uma enumeração bitfield que fornece mais configurações para as sessões de processamento. Valores atuais com suporte:

  • ETW_PROCESS_TRACE_MODE_NONE
  • ETW_PROCESS_TRACE_MODE_RAW_TIMESTAMP – os carimbos de data/hora no EVENT_RECORD fornecidos ao EventCallback não serão convertidos em tempo de arquivo como são por padrão. Em vez disso, eles permanecerão no tipo de relógio do evento original (por exemplo, QueryPerformanceCounter, contador de carimbo de data/hora da CPU ou GetSystemTimeAsFileTime).

EventCallback

Ponteiro de função do tipo PEVENT_RECORD_CALLBACK. Chamado para cada evento em ordem de tempo. Se NULL, todo o processamento de reprodução de eventos será ignorado para melhorar o desempenho.

EventCallbackContext

Contexto definido pelo usuário que estará disponível no EVENT_RECORD. UserContext dentro do EventCallback.

BufferCallback

Chamado para cada buffer depois que o processamento nesse buffer for concluído. Se NULL, nenhum retorno de chamada de buffer será executado.

BufferCallbackContext

Contexto definido pelo usuário que será passado para o BufferCallback como o parâmetro CallbackContext.

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]
Cabeçalho evntrace.h