Função OpenTraceFromRealTimeLogger (evntrace.h)

Cria uma sessão de processamento de rastreamento anexada a uma sessão ETW ativa em tempo real.

Sintaxe

ETW_APP_DECLSPEC_DEPRECATED PROCESSTRACE_HANDLE WMIAPI OpenTraceFromRealTimeLogger(
  PCWSTR                       LoggerName,
  const ETW_OPEN_TRACE_OPTIONS *Options,
  TRACE_LOGFILE_HEADER         *LogFileHeader
);

Parâmetros

LoggerName

Nome da sessão de rastreamento de evento em tempo real ou NULL se estiver processando dados de um arquivo de log. Especifique um valor para esse membro se você estiver chamando OpenTraceFromRealTimeLogger para consumir dados de uma sessão em tempo real.

Ao chamar OpenTraceFromRealTimeLogger, se LogFileHeader não for NULL, LoggerName deverá ser NULL.

Você só poderá consumir eventos em tempo real se o controlador de rastreamento tiver definido o logFileMode membro do EVENT_TRACE_PROPERTIES para incluir o sinalizador de EVENT_TRACE_REAL_TIME_MODE.

Somente usuários com privilégios administrativos, usuários no grupo Usuários de Log de Desempenho e aplicativos em execução como LocalSystem, LocalService, NetworkService podem consumir eventos em tempo real. Para conceder a um usuário restrito a capacidade de consumir eventos em tempo real, adicione-os ao grupo Usuários do Log de Desempenho ou chame EventAccessControl.

Options

Opções de configuração para esta sessão de processamento. Consulte ETW_OPEN_TRACE_OPTIONS para obter mais detalhes.

LogFileHeader

Informações de cabeçalho para o arquivo de log. Consulte TRACE_LOGFILE_HEADER para obter mais detalhes.

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

Depois que ProcessTrace for chamado noTRACEHANDLE de retornado, isso receberá buffers da sessão ETW à medida que forem liberados e começarão imediatamente a processá-los e chamar os retornos de chamada especificados noopções de .

Requisitos