t (Trace)
La commande t exécute une seule instruction ou ligne source et affiche facultativement les valeurs résultantes de tous les registres et des indicateurs. Lorsque des appels ou interruptions de sous-routine se produisent, chacune de leurs étapes est également tracée.
Mode Utilisateur
[~Thread] t [r] [= StartAddress] [Count] ["Command"]
Mode Noyau
t [r] [= StartAddress] [Count] ["Command"]
Paramètres
Fil
Spécifie les threads à libérer. Tous les autres threads sont gelés. Pour plus d’informations sur cette syntaxe, veuillez consulter la section Syntaxe des threads. Vous pouvez spécifier des threads uniquement en mode utilisateur.
r
Active et désactive l’affichage des registres et des indicateurs. Par défaut, les registres et les indicateurs sont affichés. Vous pouvez désactiver l’affichage des registres en utilisant les commandes pr, tr ou .prompt_allow -reg. Ces trois commandes contrôlent le même paramètre et vous pouvez utiliser n’importe laquelle d’entre elles pour remplacer toute utilisation précédente de ces commandes.
Vous pouvez également désactiver l’affichage des registres en utilisant la commande l-os. Ce paramètre est distinct des trois autres commandes. Pour contrôler les registres et les indicateurs à afficher, utilisez la commande rm (Masque de registre).
StartAddress
Spécifie l’adresse où l’exécution doit commencer. Si vous n’utilisez pas StartAddress, l’exécution commence à l’instruction pointée par le pointeur d’instruction. Pour plus d’informations sur la syntaxe, consultez la syntaxe d’adresse et de plage d’adresses.
Compter
Spécifie le nombre d’instructions ou de lignes source à tracer avant de s’arrêter. Chaque étape est affichée comme une action distincte dans la Fenêtre de commande du débogueur. La valeur par défaut est 1.
Commander
Spécifie une commande de débogueur à exécuter après que la trace ait été effectuée. Cette commande est exécutée avant que les résultats standard de t ne soient affichés. Si vous utilisez également Count, cette commande est exécutée après que toute la trace soit terminée (mais avant que les résultats de la dernière trace ne soient affichés).
Environnement
| Élément | Description |
|---|---|
| Modes | mode utilisateur, mode noyau |
| Targets | uniquement en débogage |
| Platforms | all |
Informations supplémentaires
Pour plus d’informations sur l’émission de la commande t et un aperçu des commandes associées, veuillez consulter la rubrique Contrôler la cible.
Notes
Lorsque vous spécifiez Count, chaque instruction est affichée au fur et à mesure qu’elle est parcourue.
Chaque trace exécute une seule instruction d’assemblage ou une seule ligne source, selon que le débogueur est en mode assemblage ou en mode source. Utilisez les commandes l+t et l-t ou les boutons de la barre d’outils WinDbg pour basculer entre ces modes.
Si vous souhaitez tracer la plupart des appels de fonction mais sauter certains appels, vous pouvez utiliser .step_filter (Définir le filtre d’étape) pour indiquer quels appels ignorer.
Vous pouvez utiliser la commande t pour tracer les instructions en ROM.
Lorsque vous tracez rapidement de nombreuses fois dans WinDbg, les fenêtres d’informations de débogage sont mises à jour après chaque trace. Si cette mise à jour entraîne une réponse plus lente, utilisez .suspend_ui (Suspendre l’interface WinDbg) pour suspendre temporairement la mise à jour de ces fenêtres.