Cabeçalho evntrace.h
Esse cabeçalho é usado por várias tecnologias. Para obter mais informações, consulte:
evntrace.h contém as seguintes interfaces de programação:
Funções
| CloseTrace A função CloseTrace fecha uma sessão de processamento de rastreamento que foi criada com OpenTrace. |
| ControlTraceA A função ControlTraceA (ANSI) (evntrace.h) libera, consulta, atualiza ou interrompe a sessão de rastreamento de eventos especificada. |
| ControlTraceW A função ControlTraceW (Unicode) (evntrace.h) libera, consulta, atualiza ou interrompe a sessão de rastreamento de eventos especificada. |
| CreateTraceInstanceId Um provedor de eventos baseado em RegisterTraceGuids ("Clássico") usa a função CreateTraceInstanceId para criar um identificador de transação exclusivo e mapeá-lo para um identificador de registro. Em seguida, o provedor pode usar o identificador de transação ao chamar a função TraceEventInstance. |
| EnableTrace Um controlador de sessão de rastreamento chama EnableTrace para configurar como um provedor de eventos ETW registra eventos em uma sessão de rastreamento. A função EnableTraceEx2 substitui essa função. |
| EnableTraceEx Um controlador de sessão de rastreamento chama EnableTraceEx para configurar como um provedor de eventos ETW registra eventos em uma sessão de rastreamento. A função EnableTraceEx2 substitui essa função. |
| EnableTraceEx2 Um controlador de sessão de rastreamento chama EnableTraceEx2 para configurar como um provedor de eventos ETW registra eventos em uma sessão de rastreamento. |
| EnumerateTraceGuids Recupera informações sobre provedores de rastreamento de eventos que estão em execução no computador. A função EnumerateTraceGuidsEx substitui essa função. |
| EnumerateTraceGuidsEx Recupera informações sobre provedores de rastreamento de eventos que estão em execução no computador. |
| FlushTraceA A função FlushTraceA (ANSI) (evntrace.h) faz com que uma sessão de rastreamento de eventos entregue imediatamente eventos armazenados em buffer para a sessão especificada. |
| FlushTraceW A função FlushTraceW (Unicode) (evntrace.h) faz com que uma sessão de rastreamento de eventos entregue imediatamente eventos armazenados em buffer para a sessão especificada. |
| GetTraceEnableFlags Um provedor de eventos baseado em RegisterTraceGuids ("Clássico") usa a função GetTraceEnableFlags para recuperar os sinalizadores de habilitação especificados pelo controlador de rastreamento para indicar qual categoria de eventos rastrear. Os provedores chamam essa função de sua função ControlCallback. |
| GetTraceEnableLevel Um provedor de eventos baseado em RegisterTraceGuids ("Clássico") usa a função GetTraceEnableLevel para recuperar o nível de habilitação especificado pelo controlador de rastreamento para indicar qual nível de eventos rastrear. Os provedores chamam essa função de sua função ControlCallback. |
| GetTraceLoggerHandle Um provedor de eventos baseado em RegisterTraceGuids ("Clássico") usa a função GetTraceLoggerHandle para recuperar o identificador da sessão de rastreamento de eventos na qual deve gravar eventos. Os provedores chamam essa função de sua função ControlCallback. |
| OpenTraceA A função OpenTraceA (ANSI) (evntrace.h) abre um identificador de processamento de rastreamento ETW para consumir eventos de uma sessão de rastreamento etw em tempo real ou de um arquivo de log ETW. |
| OpenTraceFromBufferStream Cria uma sessão de processamento de rastreamento que não está diretamente anexada a nenhum arquivo ou sessão ativa. |
| OpenTraceFromFile Cria uma sessão de processamento de rastreamento para processar um arquivo .etl do Tracelog. |
| OpenTraceFromRealTimeLogger Abre um identificador de processamento de rastreamento ETW para consumir eventos de uma sessão de rastreamento em tempo real do ETW ou de um arquivo de log ETW. |
| OpenTraceFromRealTimeLoggerWithAllocationOptions Cria uma sessão de processamento de rastreamento anexada a uma sessão ETW ativa em tempo real. |
| OpenTraceW A função OpenTraceW (Unicode) (evntrace.h) abre um identificador de processamento de rastreamento ETW para consumir eventos de uma sessão de rastreamento etw em tempo real ou de um arquivo de log ETW. |
| ProcessTrace Fornece eventos de uma ou mais sessões de processamento de rastreamento para o consumidor. |
| ProcessTraceAddBufferToBufferStream Fornece um buffer de rastreamento ETW para uma sessão de processamento criada por OpenTraceFromBufferStream. |
| ProcessTraceBufferDecrementReference Libera uma referência a um Buffer que foi adicionado por ProcessTraceBufferIncrementReference. |
| ProcessTraceBufferIncrementReference Chamado durante o BufferCallback no Buffer fornecido para evitar que ele seja liberado até que o chamador seja concluído com ele. |
| QueryAllTracesA A função QueryAllTracesA (ANSI) (evntrace.h) recupera as propriedades e estatísticas de todas as sessões de rastreamento de eventos que o chamador pode consultar. |
| QueryAllTracesW A função QueryAllTracesW (Unicode) (evntrace.h) recupera as propriedades e estatísticas de todas as sessões de rastreamento de eventos que o chamador pode consultar. |
| QueryTraceA A função QueryTraceA (ANSI) (evntrace.h) recupera as configurações de propriedade e as estatísticas de sessão para a sessão de rastreamento de eventos especificada. |
| QueryTraceProcessingHandle Recupera informações sobre uma sessão de processamento de rastreamento ETW aberta pelo OpenTrace. |
| QueryTraceW A função QueryTraceW (Unicode) (evntrace.h) recupera as configurações de propriedade e as estatísticas de sessão para a sessão de rastreamento de eventos especificada. |
| RegisterTraceGuidsA A função RegisterTraceGuidsA (ANSI) (evntrace.h) é uma função obsoleta e o novo código deve usar a alternativa fornecida. |
| RegisterTraceGuidsW A função RegisterTraceGuidsW (Unicode) (evntrace.h) é uma função obsoleta e o novo código deve usar a alternativa fornecida. |
| RemoveTraceCallback A função RemoveTraceCallback impede que uma função EventCallback receba eventos para uma classe de rastreamento de evento. Essa função está obsoleta. |
| SetTraceCallback A função SetTraceCallback especifica uma função EventCallback para processar eventos para a classe de rastreamento de evento especificada. Essa função está obsoleta. |
| StartTraceA A função StartTrace inicia uma sessão de rastreamento de eventos. (ANSI) |
| StartTraceW A função StartTrace inicia uma sessão de rastreamento de eventos. (Unicode) |
| StopTraceA A função StopTraceA (ANSI) (evntrace.h) interrompe a sessão de rastreamento de eventos especificada. A função ControlTrace substitui essa função. |
| StopTraceW A função StopTraceW (Unicode) (evntrace.h) interrompe a sessão de rastreamento de eventos especificada. A função ControlTrace substitui essa função. |
| Traceevent Um provedor de eventos baseado em RegisterTraceGuids ("Clássico") usa a função TraceEvent para enviar um evento estruturado para uma sessão de rastreamento de eventos. |
| TraceEventInstance Um provedor de eventos baseado em RegisterTraceGuids ("Clássico") usa a função TraceEventInstance para enviar um evento estruturado para uma sessão de rastreamento de eventos com um identificador de instância. |
| TraceMessage Um provedor de eventos baseado em RegisterTraceGuids ("Clássico") usa a função TraceMessage para enviar um evento WPP baseado em mensagem (baseado em TMF) para uma sessão de rastreamento de eventos. |
| TraceMessageVa Um provedor de eventos baseado em RegisterTraceGuids ("Clássico") usa a função TraceMessageVa para enviar um evento baseado em mensagem (WPP baseado em TMF) para uma sessão de rastreamento de eventos usando parâmetros va_list. |
| TraceQueryInformation Fornece informações sobre uma sessão de rastreamento de eventos. |
| TraceSetInformation Define as configurações da sessão de rastreamento de eventos. |
| UnregisterTraceGuids Cancela o registro de um provedor de rastreamento de eventos ETW "Clássico" (estilo Windows 2000) que foi registrado usando RegisterTraceGuids. |
| UpdateTraceA A função UpdateTraceA (ANSI) (evntrace.h) atualiza a configuração de propriedade da sessão de rastreamento de eventos especificada. |
| UpdateTraceW A função UpdateTraceW (Unicode) (evntrace.h) atualiza a configuração de propriedade da sessão de rastreamento de eventos especificada. |
Funções de retorno de chamada
| PETW_BUFFER_CALLBACK Definição de função para o BufferCallback que será invocado pelo ProcessTrace. |
| PETW_BUFFER_COMPLETION_CALLBACK Definição de função para o retorno de chamada que será acionado quando ProcessTraceAddBufferToBufferStream for concluído com um buffer. Esse retorno de chamada normalmente deve liberar o buffer conforme apropriado |
| PEVENT_CALLBACK Os consumidores de eventos ETW implementam esse retorno de chamada para receber eventos de uma sessão de processamento de rastreamento. O retorno de chamada EventRecordCallback substitui esse retorno de chamada. |
| PEVENT_RECORD_CALLBACK Os consumidores de eventos ETW implementam esse retorno de chamada para receber eventos de uma sessão de processamento de rastreamento. O tipo PEVENT_RECORD_CALLBACK define um ponteiro para essa função de retorno de chamada. EventRecordCallback é um espaço reservado para o nome da função definida pelo aplicativo. |
| PEVENT_TRACE_BUFFER_CALLBACKA A função PEVENT_TRACE_BUFFER_CALLBACKA (ANSI) (evntrace.h) obtém estatísticas sobre cada buffer de eventos que o ETW envia durante uma sessão de processamento de rastreamento. |
| PEVENT_TRACE_BUFFER_CALLBACKW A função PEVENT_TRACE_BUFFER_CALLBACKW (Unicode) (evntrace.h) obtém estatísticas sobre cada buffer de eventos que o ETW envia durante uma sessão de processamento de rastreamento. |
| WMIDPREQUEST Um provedor de eventos baseado em RegisterTraceGuids ("Clássico") implementa essa função para receber notificações de controladores. O tipo WMIDPREQUEST define um ponteiro para essa função de retorno de chamada. ControlCallback é um espaço reservado para o nome da função definida pelo aplicativo. |
Estruturas
| CLASSIC_EVENT_ID Identifica o evento kernel para o qual você deseja habilitar o rastreamento de pilha de chamadas. |
| ENABLE_TRACE_PARAMETERS Contém informações usadas para habilitar um provedor por meio de EnableTraceEx2. |
| ENABLE_TRACE_PARAMETERS_V1 Contém informações usadas para habilitar um provedor por meio de EnableTraceEx2. Essa estrutura está obsoleta. |
| ETW_BUFFER_CALLBACK_INFORMATION Fornecido ao BufferCallback como o parâmetro ConsumerInfo e fornece detalhes sobre a sessão de processamento atual. |
| ETW_BUFFER_CONTEXT Fornece informações de contexto sobre o evento. |
| ETW_BUFFER_HEADER A estrutura de cabeçalho de um buffer ETW. |
| ETW_OPEN_TRACE_OPTIONS Fornece parâmetros de configuração para as funções OpenTraceFromBufferStream, OpenTraceFromFile, OpenTraceFromRealTimeLogger, OpenTraceFromRealTimeLoggerWithAllocationOptions. |
| ETW_TRACE_PARTITION_INFORMATION Contém informações de partição extraídas de um rastreamento ETW. |
| EVENT_INSTANCE_HEADER A estrutura EVENT_INSTANCE_HEADER contém informações de rastreamento de eventos padrão comuns a todos os eventos gravados por TraceEventInstance. |
| EVENT_INSTANCE_INFO A estrutura EVENT_INSTANCE_INFO mapeia um identificador de transação exclusivo para uma classe de rastreamento de evento registrada para TraceEventInstance. |
| EVENT_TRACE A estrutura EVENT_TRACE é usada para fornecer informações de evento a um consumidor de rastreamento de eventos. |
| EVENT_TRACE_HEADER A estrutura EVENT_TRACE_HEADER contém informações de rastreamento de eventos padrão comuns a todos os eventos gravados por TraceEvent. |
| EVENT_TRACE_LOGFILEA A estrutura ansi (EVENT_TRACE_LOGFILEA) (evntrace.h) armazena informações sobre uma fonte de dados de rastreamento. |
| EVENT_TRACE_LOGFILEW A estrutura EVENT_TRACE_LOGFILEW (Unicode) (evntrace.h) armazena informações sobre uma fonte de dados de rastreamento. |
| EVENT_TRACE_PROPERTIES A estrutura EVENT_TRACE_PROPERTIES contém informações sobre uma sessão de rastreamento de eventos e é usada com APIs como StartTrace e ControlTrace. |
| EVENT_TRACE_PROPERTIES_V2 A estrutura EVENT_TRACE_PROPERTIES_V2 contém informações sobre uma sessão de rastreamento de eventos e é usada com APIs como StartTrace e ControlTrace. |
| MOF_FIELD Você pode usar as estruturas de MOF_FIELD para acrescentar dados de evento às estruturas EVENT_TRACE_HEADER ou EVENT_INSTANCE_HEADER. |
| TRACE_ENABLE_INFO Define a sessão e as informações que a sessão usou para habilitar o provedor. |
| TRACE_GUID_INFO Retornado por EnumerateTraceGuidsEx. Define o cabeçalho para a lista de sessões que habilitaram um provedor. |
| TRACE_GUID_PROPERTIES Retornado por EnumerateTraceGuids. Contém informações sobre um provedor de rastreamento de eventos. |
| TRACE_GUID_REGISTRATION Usado com RegisterTraceGuids para registrar classes de rastreamento de eventos. |
| TRACE_LOGFILE_HEADER A estrutura TRACE_LOGFILE_HEADER contém informações sobre uma sessão de rastreamento de eventos e seus eventos. |
| TRACE_PERIODIC_CAPTURE_STATE_INFO Usado com TraceQueryInformation e TraceSetInformation para obter ou definir informações relacionadas a um estado de captura periódico. |
| TRACE_PROVIDER_INSTANCE_INFO Define uma instância do GUID do provedor. |
| TRACE_VERSION_INFO Determina as informações de versão da sessão TraceLogging. |
Enumerações
| ETW_PROCESS_HANDLE_INFO_TYPE Especifica a operação que será executada em uma sessão de processamento de rastreamento. |
| ETW_PROCESS_TRACE_MODES Especifica os modos de rastreamento de processo com suporte. |
| TRACE_QUERY_INFO_CLASS Usado com EnumerateTraceGuidsEx e TraceSetInformation para especificar um tipo de informação de rastreamento. |
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de