énumération TDH_CONTEXT_TYPE (tdh.h)

Article
03/06/2024

Définit le type de contexte.

Syntax

typedef enum _TDH_CONTEXT_TYPE {
  TDH_CONTEXT_WPP_TMFFILE,
  TDH_CONTEXT_WPP_TMFSEARCHPATH,
  TDH_CONTEXT_WPP_GMT,
  TDH_CONTEXT_POINTERSIZE,
  TDH_CONTEXT_PDB_PATH,
  TDH_CONTEXT_MAXIMUM
} TDH_CONTEXT_TYPE;

Constantes


`TDH_CONTEXT_WPP_TMFFILE` Chaîne Unicode terminée par null qui contient le nom du fichier .tmf utilisé pour l’analyse du journal WPP. En règle générale, le nom de fichier .tmf est récupéré à partir du GUID d’événement. Vous n’avez donc pas à spécifier le nom de fichier.
`TDH_CONTEXT_WPP_TMFSEARCHPATH` Chaîne Unicode terminée par null qui contient le chemin d’accès au fichier .tmf. Vous n’avez pas besoin de spécifier ce chemin si le chemin d’accès de recherche contient le fichier. Spécifiez uniquement ces informations de contexte si vous spécifiez également le type de contexte TDH_CONTEXT_WPP_TMFFILE. Si le fichier est introuvable, TDH recherche les emplacements suivants dans l’ordre donné : Chemin spécifié dans la variable d’environnement TRACE_FORMAT_SEARCH_PATH Dossier actif
`TDH_CONTEXT_WPP_GMT` Indicateur booléen de 1 octet qui indique si l’horodatage d’événement WPP doit être converti en coordonnées utc (Universal Time Coordonnée). Si la valeur est 1, l’horodatage est converti en UTC. Si la valeur est 0, l’horodatage est en heure locale. Par défaut, l’horodatage est en heure locale.
`TDH_CONTEXT_POINTERSIZE` Taille, en octets, des types de données pointeur ou size_t types de données utilisés dans l’événement. Indique si l’événement a utilisé des valeurs de 4 octets ou de 8 octets. Par défaut, la taille du pointeur est la taille du pointeur de l’ordinateur de décodage. Pour déterminer la taille du pointeur ou de la valeur size_t, utilisez le membre PointerSize de TRACE_LOGFILE_HEADER (le premier événement que vous recevez dans votre rappel EventRecordCallback contient cet en-tête dans la section données). Toutefois, cette valeur peut ne pas être exacte. Par exemple, sur un ordinateur 64 bits, une application 32 bits enregistre des pointeurs de 4 octets ; Toutefois, la session définit PointerSize sur 8.
`TDH_CONTEXT_PDB_PATH` Chaîne Unicode terminée par null qui contient le nom du fichier .pdb pour le fichier binaire qui contient les messages WPP. Ce paramètre peut être utilisé comme alternative à TDH_CONTEXT_WPP_TMFFILE ou TDH_CONTEXT_WPP_TMFSEARCHPATH. Note Disponible uniquement pour les Windows 8 et les Windows Server 2012.
`TDH_CONTEXT_MAXIMUM` Réservé.

Remarques

Si vous spécifiez des informations de contexte pour un événement ETW hérité, vous devez uniquement spécifier le type TDH_CONTEXT_POINTERSIZE : les autres types sont utilisés pour les événements WPP et sont ignorés pour les événements ETW hérités.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	tdh.h

Voir aussi

TDH_CONTEXT

Partager via