evntrace.h en-tête

Cet en-tête est utilisé par plusieurs technologies. Pour en savoir plus, consultez :

• Suivi d’événements
• Informations de référence sur le piloteKernel-Mode

evntrace.h contient les interfaces de programmation suivantes :

Functions

CloseTrace La fonction CloseTrace ferme une session de traitement de trace créée avec OpenTrace.
ControlTraceA La fonction ControlTraceA (ANSI) (evntrace.h) vide, interroge, met à jour ou arrête la session de suivi d’événements spécifiée.
ControlTraceW La fonction ControlTraceW (Unicode) (evntrace.h) vide, interroge, met à jour ou arrête la session de suivi d’événements spécifiée.
CreateTraceInstanceId Un fournisseur d’événements basé sur RegisterTraceGuids (« Classique ») utilise la fonction CreateTraceInstanceId pour créer un identificateur de transaction unique et le mapper à un handle d’inscription. Le fournisseur peut ensuite utiliser l’identificateur de transaction lors de l’appel de la fonction TraceEventInstance.
EnableTrace Un contrôleur de session de suivi appelle EnableTrace pour configurer la façon dont un fournisseur d’événements ETW journalise les événements dans une session de suivi. La fonction EnableTraceEx2 remplace cette fonction.
EnableTraceEx Un contrôleur de session de suivi appelle EnableTraceEx pour configurer la façon dont un fournisseur d’événements ETW journalise les événements dans une session de suivi. La fonction EnableTraceEx2 remplace cette fonction.
EnableTraceEx2 Un contrôleur de session de suivi appelle EnableTraceEx2 pour configurer la façon dont un fournisseur d’événements ETW journalise les événements dans une session de suivi.
EnumerateTraceGuids Récupère des informations sur les fournisseurs de trace d’événements en cours d’exécution sur l’ordinateur. La fonction EnumerateTraceGuidsEx remplace cette fonction.
EnumerateTraceGuidsEx Récupère des informations sur les fournisseurs de trace d’événements en cours d’exécution sur l’ordinateur.
FlushTraceA La fonction FlushTraceA (ANSI) (evntrace.h) entraîne la remise immédiate d’événements mis en mémoire tampon pour la session spécifiée.
FlushTraceW La fonction FlushTraceW (Unicode) (evntrace.h) entraîne la remise immédiate d’événements mis en mémoire tampon pour la session spécifiée.
GetTraceEnableFlags Un fournisseur d’événements basé sur RegisterTraceGuids (« Classique ») utilise la fonction GetTraceEnableFlags pour récupérer les indicateurs d’activation spécifiés par le contrôleur de trace pour indiquer la catégorie d’événements à suivre. Les fournisseurs appellent cette fonction à partir de leur fonction ControlCallback.
GetTraceEnableLevel Un fournisseur d’événements basé sur RegisterTraceGuids (« Classique ») utilise la fonction GetTraceEnableLevel pour récupérer le niveau d’activation spécifié par le contrôleur de trace pour indiquer le niveau d’événements à suivre. Les fournisseurs appellent cette fonction à partir de leur fonction ControlCallback.
GetTraceLoggerHandle Un fournisseur d’événements basé sur RegisterTraceGuids (« Classique ») utilise la fonction GetTraceLoggerHandle pour récupérer le handle de la session de suivi d’événements dans laquelle il doit écrire des événements. Les fournisseurs appellent cette fonction à partir de leur fonction ControlCallback.
OpenTraceA La fonction OpenTraceA (ANSI) (evntrace.h) ouvre un handle de traitement de trace ETW pour consommer des événements à partir d’une session de trace ETW en temps réel ou d’un fichier journal ETW.
OpenTraceFromBufferStream Crée une session de traitement de suivi qui n’est pas directement attachée à un fichier ou à une session active.
OpenTraceFromFile Crée une session de traitement de suivi pour traiter un fichier Tracelog .etl.
OpenTraceFromRealTimeLogger Ouvre un handle de traitement de suivi ETW pour consommer des événements à partir d’une session de trace en temps réel ETW ou d’un fichier journal ETW.
OpenTraceFromRealTimeLoggerWithAllocationOptions Crée une session de traitement de suivi attachée à une session ETW active en temps réel.
OpenTraceW La fonction OpenTraceW (Unicode) (evntrace.h) ouvre un handle de traitement de trace ETW pour consommer des événements à partir d’une session de trace ETW en temps réel ou d’un fichier journal ETW.
ProcessTrace Remet des événements d’une ou plusieurs sessions de traitement de suivi au consommateur.
ProcessTraceAddBufferToBufferStream Fournit une mémoire tampon de trace ETW à une session de traitement créée par OpenTraceFromBufferStream.
ProcessTraceBufferDecrementReference Libère une référence à une mémoire tampon ajoutée par ProcessTraceBufferIncrementReference.
ProcessTraceBufferIncrementReference Appelé pendant le BufferCallback sur la mémoire tampon fournie pour l’empêcher d’être libéré jusqu’à ce que l’appelant soit terminé avec celui-ci.
QueryAllTracesA La fonction QueryAllTracesA (ANSI) (evntrace.h) récupère les propriétés et les statistiques de toutes les sessions de suivi d’événements que l’appelant peut interroger.
QueryAllTracesW La fonction QueryAllTracesW (Unicode) (evntrace.h) récupère les propriétés et les statistiques de toutes les sessions de suivi d’événements que l’appelant peut interroger.
QueryTraceA La fonction QueryTraceA (ANSI) (evntrace.h) récupère les paramètres de propriété et les statistiques de session pour la session de suivi d’événements spécifiée.
QueryTraceProcessingHandle Récupère des informations sur une session de traitement de suivi ETW ouverte par OpenTrace.
QueryTraceW La fonction QueryTraceW (Unicode) (evntrace.h) récupère les paramètres de propriété et les statistiques de session pour la session de suivi d’événements spécifiée.
RegisterTraceGuidsA La fonction RegisterTraceGuidsA (ANSI) (evntrace.h) est une fonction obsolète et le nouveau code doit utiliser l’alternative fournie.
RegisterTraceGuidsW La fonction RegisterTraceGuidsW (Unicode) (evntrace.h) est une fonction obsolète et le nouveau code doit utiliser l’alternative fournie.
RemoveTraceCallback La fonction RemoveTraceCallback arrête une fonction EventCallback de recevoir des événements pour une classe de trace d’événements. Cette fonction est obsolète.
SetTraceCallback La fonction SetTraceCallback spécifie une fonction EventCallback pour traiter les événements de la classe de trace d’événements spécifiée. Cette fonction est obsolète.
StartTraceA La fonction StartTrace démarre une session de suivi d’événements. (ANSI)
StartTraceW La fonction StartTrace démarre une session de suivi d’événements. (Unicode)
StopTraceA La fonction StopTraceA (ANSI) (evntrace.h) arrête la session de suivi d’événements spécifiée. La fonction ControlTrace remplace cette fonction.
StopTraceW La fonction StopTraceW (Unicode) (evntrace.h) arrête la session de suivi d’événements spécifiée. La fonction ControlTrace remplace cette fonction.
TraceConfigureLastBranchRecord Configure un suivi d’événements pour la session Windows (ETW) pour générer des événements de suivi DBR (Last Branch Record) en réponse aux événements déclencheurs spécifiés.
TraceEvent Un fournisseur d’événements basé sur RegisterTraceGuids (« Classique ») utilise la fonction TraceEvent pour envoyer un événement structuré à une session de suivi d’événements.
TraceEventInstance Un fournisseur d’événements basé sur RegisterTraceGuids (« Classique ») utilise la fonction TraceEventInstance pour envoyer un événement structuré à une session de suivi d’événements avec un identificateur d’instance.
TraceMessage Un fournisseur d’événements basé sur RegisterTraceGuids (« Classique ») utilise la fonction TraceMessage pour envoyer un événement WPP basé sur un message (TMF) à une session de suivi d’événements.
TraceMessageVa Un fournisseur d’événements basé sur RegisterTraceGuids (« Classique ») utilise la fonction TraceMessageVa pour envoyer un événement WPP basé sur un message (TMF) à une session de suivi d’événements à l’aide de paramètres va_list.
TraceQueryInformation Fournit des informations sur une session de suivi d’événements.
TraceSetInformation Configure les paramètres de session de suivi des événements.
DésinscrireTraceGuids Annule l’inscription d’un fournisseur de trace d’événements ETW « Classique » (Windows style 2000) inscrit à l’aide de RegisterTraceGuids.
UpdateTraceA La fonction UpdateTraceA (ANSI) (evntrace.h) met à jour le paramètre de propriété de la session de suivi d’événements spécifiée.
UpdateTraceW La fonction UpdateTraceW (Unicode) (evntrace.h) met à jour le paramètre de propriété de la session de suivi d’événements spécifiée.

Fonctions de rappel

PETW_BUFFER_CALLBACK Définition de fonction pour BufferCallback qui sera appelée par ProcessTrace.
PETW_BUFFER_COMPLETION_CALLBACK Définition de fonction pour le rappel qui sera déclenché lorsque ProcessTraceAddBufferToBufferStream est terminé avec une mémoire tampon. Ce rappel doit généralement libérer la mémoire tampon selon les besoins
PEVENT_CALLBACK Les consommateurs d’événements ETW implémentent ce rappel pour recevoir des événements d’une session de traitement de suivi. Le rappel EventRecordCallback remplace ce rappel.
PEVENT_RECORD_CALLBACK Les consommateurs d’événements ETW implémentent ce rappel pour recevoir des événements d’une session de traitement de suivi. Le type PEVENT_RECORD_CALLBACK définit un pointeur vers cette fonction de rappel. EventRecordCallback est un espace réservé pour le nom de la fonction définie par l’application.
PEVENT_TRACE_BUFFER_CALLBACKA La fonction PEVENT_TRACE_BUFFER_CALLBACKA (ANSI) (evntrace.h) obtient des statistiques sur chaque mémoire tampon des événements envoyés par ETW pendant une session de traitement de trace.
PEVENT_TRACE_BUFFER_CALLBACKW La fonction PEVENT_TRACE_BUFFER_CALLBACKW (Unicode) (evntrace.h) obtient des statistiques sur chaque mémoire tampon des événements envoyés par ETW pendant une session de traitement de trace.
WMIDPREQUEST Un fournisseur d’événements basé sur RegisterTraceGuids (« Classique ») implémente cette fonction pour recevoir des notifications des contrôleurs. Le type WMIDPREQUEST définit un pointeur vers cette fonction de rappel. ControlCallback est un espace réservé pour le nom de la fonction définie par l’application.

Structures

CLASSIC_EVENT_ID Identifie l’événement de noyau pour lequel vous souhaitez activer le suivi de la pile des appels.
ENABLE_TRACE_PARAMETERS Contient des informations utilisées pour activer un fournisseur via EnableTraceEx2.
ENABLE_TRACE_PARAMETERS_V1 Contient des informations utilisées pour activer un fournisseur via EnableTraceEx2. Cette structure est obsolète.
ETW_BUFFER_CALLBACK_INFORMATION Fourni à BufferCallback en tant que paramètre ConsumerInfo et fournit des détails sur la session de traitement actuelle.
ETW_BUFFER_CONTEXT Fournit des informations contextuelles sur l’événement.
ETW_BUFFER_HEADER Structure d’en-tête d’une mémoire tampon ETW.
ETW_OPEN_TRACE_OPTIONS Fournit des paramètres de configuration à OpenTraceFromBufferStream, OpenTraceFromFile, OpenTraceFromRealTimeLogger, OpenTraceFromRealTimeLoggerWithAllocationOptions.
ETW_TRACE_PARTITION_INFORMATION Contient des informations de partition extraites d’une trace ETW.
EVENT_INSTANCE_HEADER La structure EVENT_INSTANCE_HEADER contient des informations de suivi d’événements standard communes à tous les événements écrits par TraceEventInstance.
EVENT_INSTANCE_INFO La structure EVENT_INSTANCE_INFO mappe un identificateur de transaction unique à une classe de trace d’événements inscrite pour TraceEventInstance.
EVENT_TRACE La structure EVENT_TRACE est utilisée pour fournir des informations sur les événements à un consommateur de trace d’événements.
EVENT_TRACE_HEADER La structure EVENT_TRACE_HEADER contient des informations de suivi d’événements standard communes à tous les événements écrits par TraceEvent.
EVENT_TRACE_LOGFILEA La structure EVENT_TRACE_LOGFILEA (ANSI) (evntrace.h) stocke des informations sur une source de données de trace.
EVENT_TRACE_LOGFILEW La structure EVENT_TRACE_LOGFILEW (Unicode) (evntrace.h) stocke des informations sur une source de données de trace.
EVENT_TRACE_PROPERTIES La structure EVENT_TRACE_PROPERTIES contient des informations sur une session de suivi d’événements et est utilisée avec des API telles que StartTrace et ControlTrace.
EVENT_TRACE_PROPERTIES_V2 La structure EVENT_TRACE_PROPERTIES_V2 contient des informations sur une session de suivi d’événements et est utilisée avec des API telles que StartTrace et ControlTrace.
MOF_FIELD Vous pouvez utiliser les structures MOF_FIELD pour ajouter des données d’événement aux structures EVENT_TRACE_HEADER ou EVENT_INSTANCE_HEADER.
TRACE_CONTEXT_REGISTER_INFO Identifie l’ensemble des registres à journaliser lors de l’activation du suivi du registre de contexte.
TRACE_ENABLE_INFO Définit la session et les informations utilisées pour activer le fournisseur.
TRACE_GUID_INFO Retourné par EnumerateTraceGuidsEx. Définit l’en-tête à la liste des sessions qui ont activé un fournisseur.
TRACE_GUID_PROPERTIES Retourné par EnumerateTraceGuids. Contient des informations sur un fournisseur de trace d’événements.
TRACE_GUID_REGISTRATION Utilisé avec RegisterTraceGuids pour inscrire des classes de trace d’événements.
TRACE_LOGFILE_HEADER La structure TRACE_LOGFILE_HEADER contient des informations sur une session de suivi d’événements et ses événements.
TRACE_PERIODIC_CAPTURE_STATE_INFO Utilisé avec TraceQueryInformation et TraceSetInformation pour obtenir ou définir des informations relatives à un état de capture périodique.
TRACE_PROVIDER_INSTANCE_INFO Définit une instance du GUID du fournisseur.
TRACE_VERSION_INFO Détermine les informations de version de la session TraceLogging.

Enumerations

ETW_CONTEXT_REGISTER_TYPES Spécifie l’ensemble des registres à collecter lorsque le suivi du registre de contexte est activé.
ETW_PROCESS_HANDLE_INFO_TYPE Spécifie l’opération qui sera effectuée sur une session de traitement de suivi.
ETW_PROCESS_TRACE_MODES Spécifie les modes de trace de processus pris en charge.
TRACE_QUERY_INFO_CLASS Utilisé avec EnumerateTraceGuidsEx et TraceSetInformation pour spécifier un type d’informations de trace.