p (Step)

La commande p 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 de sous-routine ou des interruptions se produisent, ils sont traités comme une seule étape.

Mode Utilisateur

[~Thread] p[r] [= StartAddress] [Count] ["Command"] 

Mode Noyau

p[r] [= StartAddress] [Count] ["Command"] 

Paramètres

Thread
Spécifie les threads à continuer d’exécuter. Tous les autres threads sont gelés. Pour plus d’informations sur la 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.

Count
Spécifie le nombre d’instructions ou de lignes source à parcourir 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.

Interface
Spécifie une commande de débogueur à exécuter après que le pas ait été effectué. Cette commande est exécutée avant que les résultats standard de p ne soient affichés. Si vous utilisez également Count, la commande spécifiée est exécutée après que tout le pas soit terminé (mais avant que les résultats du dernier pas ne soient affichés).

Environnement

Élément	Description
Modes	mode utilisateur, mode noyau
Targets	uniquement en débogage
Plateformes	all

Informations supplémentaires

Pour plus d’informations sur l’émission de la commande p 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.

Si le débogueur rencontre une instruction call ou une interruption pendant le pas, la sous-routine appelée sera entièrement exécutée à moins qu’un point d’arrêt ne soit rencontré. Le contrôle est renvoyé au débogueur à l’instruction suivante après l’appel ou l’interruption.

Chaque pas 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.

Lorsque vous effectuez rapidement de nombreux pas dans WinDbg, les fenêtres d’informations de débogage sont mises à jour après chaque pas. Si cette mise à jour entraîne une réponse plus lente, utilisez .suspend_ui (Suspendre l’interface WinDbg) pour suspendre temporairement le rafraîchissement de ces fenêtres.