en-tête evntrace.h

Cet en-tête est utilisé par plusieurs technologies. Pour plus d'informations, consultez les pages suivantes :

• Suivi d’événements
• Référence du pilote en mode noyau

evntrace.h contient les interfaces de programmation suivantes :

Fonctions

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 traces 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 traces d’événements en cours d’exécution sur l’ordinateur.
FlushTraceA La fonction FlushTraceA (ANSI) (evntrace.h) permet à une session de suivi d’événements de remettre immédiatement des événements mis en mémoire tampon pour la session spécifiée.
FlushTraceW La fonction FlushTraceW (Unicode) (evntrace.h) permet à une session de suivi d’événements de remettre immédiatement des é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 afin d’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 afin d’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 la consommation d’événements d’une session de trace en temps réel ETW ou d’un fichier journal ETW.
OpenTraceFromBufferStream Crée une session de traitement de trace qui n’est pas directement attachée à un fichier ou à une session active.
OpenTraceFromFile Crée une session de traitement de trace pour traiter un fichier .etl Tracelog.
OpenTraceFromRealTimeLogger Ouvre un handle de traitement des traces ETW pour la consommation d’événements d’une session de suivi en temps réel ETW ou d’un fichier journal ETW.
OpenTraceFromRealTimeLoggerWithAllocationOptions Crée une session de traitement des traces 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 d’une session de suivi en temps réel ETW ou d’un fichier journal ETW.
ProcessTrace Remet les événements d’une ou plusieurs sessions de traitement de trace 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 qui a été ajoutée par ProcessTraceBufferIncrementReference.
ProcessTraceBufferIncrementReference Appelé pendant le BufferCallback sur la mémoire tampon fournie pour empêcher sa libération tant que l’appelant n’en a pas terminé.
QueryAllTracesA La fonction QueryAllTracesA (ANSI) (evntrace.h) récupère les propriétés et 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 trace 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 empêche 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.
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 instance.
TraceMessage Un fournisseur d’événements Basé sur RegisterTraceGuids (« Classique ») utilise la fonction TraceMessage pour envoyer un événement basé sur un message (WPP basé sur 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 basé sur un message (WPP basé sur 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 » (de style Windows 2000) qui a été 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 des é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 des événements spécifiée.

Fonctions de rappel

PETW_BUFFER_CALLBACK Définition de fonction pour le BufferCallback qui sera appelé par ProcessTrace.
PETW_BUFFER_COMPLETION_CALLBACK Définition de la fonction pour le rappel qui sera déclenché lorsque ProcessTraceAddBufferToBufferStream aura terminé avec une mémoire tampon. Ce rappel doit généralement libérer la mémoire tampon le cas échéant
PEVENT_CALLBACK Les consommateurs d’événements ETW implémentent ce rappel pour recevoir les événements d’une session de traitement de trace. Le rappel EventRecordCallback remplace ce rappel.
PEVENT_RECORD_CALLBACK Les consommateurs d’événements ETW implémentent ce rappel pour recevoir les événements d’une session de traitement de trace. Le type PEVENT_RECORD_CALLBACK définit un pointeur vers cette fonction de rappel. EventRecordCallback est un espace réservé pour le nom de fonction défini 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 d’événements qu’ETW envoie 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 fonction défini par l’application.

Structures

CLASSIC_EVENT_ID Identifie l’événement de noyau pour lequel vous souhaitez activer le suivi de pile des appels.
ENABLE_TRACE_PARAMETERS Contient les informations utilisées pour activer un fournisseur via EnableTraceEx2.
ENABLE_TRACE_PARAMETERS_V1 Contient les 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 de contexte 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 pour les fonctions 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 d’événement à un consommateur de trace d’événement.
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_ENABLE_INFO Définit la session et les informations utilisées par la session pour activer le fournisseur.
TRACE_GUID_INFO Retourné par EnumerateTraceGuidsEx. Définit l’en-tête de la liste des sessions qui ont activé un fournisseur.
TRACE_GUID_PROPERTIES Retourné par EnumerateTraceGuids. Contient des informations sur un fournisseur de suivi 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.

Énumérations

ETW_PROCESS_HANDLE_INFO_TYPE Spécifie l’opération qui sera effectuée sur une session de traitement de trace.
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.