.printf
Le jeton .printf se comporte comme l’instruction printf en C.
.printf [/D] [Option] "FormatString" [, Argument , ...]
Éléments de syntaxe
/D
Spécifie que la chaîne de format contient le langage de balisage du débogueur (DML).
Option
(WinDbg uniquement) Spécifie le type de message texte que WinDbg doit interpréter le FormatString comme. WinDbg attribue à chaque type de message de fenêtre de commande du débogueur un arrière-plan et une couleur de texte ; le choix de l’une de ces options entraîne l’affichage du message dans les couleurs appropriées. La valeur par défaut consiste à afficher le texte sous la forme d’un message de niveau normal.
Les options suivantes sont disponibles :
| Option | Type de message | Titre des couleurs dans la boîte de dialogue Options |
|---|---|---|
/od |
déboguer |
Fenêtre de commande au niveau du débogage |
/Od |
Invite de débogage |
Fenêtre de commande Debuggee au niveau de l’invite |
/Π|
error |
Fenêtre de commande au niveau de l’erreur |
/on |
normal |
Fenêtre de commande de niveau normal |
/op |
prompt |
Fenêtre de commande au niveau de l’invite |
/Op |
registres d’invite |
Fenêtre de commande d’inscription au niveau de l’invite |
/os |
symboles |
Fenêtre de commande au niveau du message de symbole |
/Ov |
commentaires |
Fenêtre de commande de niveau détaillé |
/ah |
avertissement |
Fenêtre de commande au niveau de l’avertissement |
FormatString
Spécifie la chaîne de format, comme dans printf. En général, les caractères de conversion fonctionnent exactement comme en C. Pour les caractères de conversion à virgule flottante, l’argument 64 bits est interprété comme un nombre à virgule flottante 32 bits, sauf si le modificateur l est utilisé.
Le modificateur « I64 » peut être ajouté pour indiquer qu’une valeur doit être interprétée comme 64 bits. Par exemple, « %I64x » peut être utilisé pour imprimer un nombre hexadécimal 64 bits.
Le caractère de conversion %p est pris en charge, mais il représente un pointeur dans l’espace d’adressage virtuel de la cible. Il ne doit pas avoir de modificateurs et utilise la mise en forme d’adresse interne du débogueur. Outre les spécificateurs de format printf standard, les caractères de conversion supplémentaires suivants sont pris en charge.
| Caractère | Type d’argument | Argument | Texte imprimé |
|---|---|---|---|
%p |
ULONG64 |
Pointeur dans l’espace d’adressage virtuel de la cible. |
Valeur du pointeur. |
%N |
DWORD_PTR (32 ou 64 bits, selon l’architecture de l’hôte) |
Pointeur dans l’espace d’adressage virtuel de l’hôte. |
Valeur du pointeur. (Cela équivaut au caractère C %p standard.) |
%ma |
ULONG64 |
Adresse d’une chaîne ASCII terminée par NULL dans l’espace d’adressage virtuel de la cible. |
Chaîne spécifiée. |
%mu |
ULONG64 |
Adresse d’une chaîne Unicode terminée par NULL dans l’espace d’adressage virtuel de la cible. |
Chaîne spécifiée. |
%msa |
ULONG64 |
Adresse d’une structure ANSI_STRING dans l’espace d’adressage virtuel de la cible. |
Chaîne spécifiée. |
%msu |
ULONG64 |
Adresse d’une structure UNICODE_STRING dans l’espace d’adressage virtuel de la cible. |
Chaîne spécifiée. |
%y |
ULONG64 |
Adresse d’un symbole de débogueur dans l’espace d’adressage virtuel de la cible. |
Chaîne contenant le nom du symbole spécifié (et déplacement, le cas échéant). |
%ly |
ULONG64 |
Adresse d’un symbole de débogueur dans l’espace d’adressage virtuel de la cible. |
Chaîne contenant le nom du symbole spécifié (et déplacement, le cas échéant), ainsi que les informations de ligne source disponibles. |
Arguments
Spécifie les arguments de la chaîne de format, comme dans printf. Le nombre d’arguments spécifiés doit correspondre au nombre de caractères de conversion dans FormatString. Chaque argument est une expression qui sera évaluée par l’évaluateur d’expression par défaut (MASM ou C++). Pour plus d’informations, consultez Syntaxe d’expression numérique.
Informations supplémentaires
Pour plus d’informations sur les autres jetons de flux de contrôle et leur utilisation dans les programmes de commandes du débogueur, consultez Utilisation des programmes de commande du débogueur.
Notes
Les paramètres de couleur que vous pouvez choisir à l’aide du paramètre Options sont par défaut tous définis sur du texte noir sur un arrière-plan blanc. Pour optimiser l’utilisation de ces options, vous devez d’abord utiliser View | Options permettant d’ouvrir la boîte de dialogue Options et de modifier les paramètres de couleur des messages de la fenêtre Commande du débogueur.
L’exemple suivant montre comment inclure une balise DML dans la chaîne de format.
.printf /D "Click <link cmd=\".chain /D\">here</link> to see extensions DLLs."
La sortie affichée dans l’image précédente a un lien que vous pouvez cliquer pour exécuter la commande spécifiée dans la <link> balise. L’image suivante montre le résultat d’un clic sur le lien.
Pour plus d’informations sur les balises DML, consultez dml.doc dans le dossier d’installation des outils de débogage pour Windows.