.Printf

Das PRINTF-Token verhält sich wie die printf-Anweisung in C.

.printf [/D] [Option] "FormatString" [, Argument , ...] 

Syntaxelemente

/D
Gibt an, dass die Formatzeichenfolge Debugger Markup Language (DML) enthält.

Option
(Nur WinDbg) Gibt den Typ der Textnachricht an, als den WinDbg formatString interpretieren soll. WinDbg weist jedem Typ der Debuggerbefehlsfenstermeldung eine Hintergrund- und Textfarbe zu. Wenn Sie eine dieser Optionen auswählen, wird die Meldung in den entsprechenden Farben angezeigt. Standardmäßig wird der Text als Meldung auf normaler Ebene angezeigt.

Die folgenden Optionen sind verfügbar.

Option	Typ der Nachricht	Titel der Farben im Dialogfeld "Optionen"
/od	debuggee	Befehlsfenster auf Debuggeeeebene
/Od	Debuggee-Eingabeaufforderung	Debuggee-Befehlsfenster auf Eingabeaufforderungsebene
/Oe	error	Befehlsfenster auf Fehlerebene
/on	normal	Befehlsfenster auf normaler Ebene
/Op	prompt	Befehlsfenster auf Eingabeaufforderungsebene
/Op	Eingabeaufforderungsregistrierungen	Befehlsfenster für Eingabeaufforderungsregistrierungen auf Ebene
/os	Symbole	Befehlsfenster auf Symbolmeldungsebene
/Ov	Ausführlich	Befehlsfenster auf ausführlicher Ebene
/Ow	warning	Befehlsfenster auf Warnungsebene

Formatstring
Gibt die Formatzeichenfolge an, wie in printf. Im Allgemeinen funktionieren Konvertierungszeichen genau wie in C. Für Gleitkommakonvertierungszeichen wird das 64-Bit-Argument als 32-Bit-Gleitkommazahl interpretiert, es sei denn, der l-Modifizierer wird verwendet.

Der "I64"-Modifizierer kann hinzugefügt werden, um anzugeben, dass ein Wert als 64-Bit interpretiert werden soll. Für instance kann "%I64x" verwendet werden, um eine 64-Bit-Hexadezimalzahl zu drucken.

Das %p-Konvertierungszeichen wird unterstützt, stellt jedoch einen Zeiger im virtuellen Adressraum des Ziels dar. Es darf keine Modifizierer haben und verwendet die interne Adressformatierung des Debuggers. Zusätzlich zu den Standardformatbezeichnern im Printf-Stil werden die folgenden zusätzlichen Konvertierungszeichen unterstützt.

Zeichen	Argumenttyp	Argument	Gedruckter Text
%p	ULONG64	Ein Zeiger im virtuellen Adressraum des Ziels.	Der Wert des Zeigers.
%N	DWORD_PTR (32 oder 64 Bits, abhängig von der Architektur des Hosts)	Ein Zeiger im virtuellen Adressraum des Hosts.	Der Wert des Zeigers. (Dies entspricht dem C %p-Standardzeichen.)
%ma	ULONG64	Die Adresse einer NULL-beendeten ASCII-Zeichenfolge im virtuellen Adressraum des Ziels.	Die angegebene Zeichenfolge.
%mu	ULONG64	Die Adresse einer MIT NULL beendeten Unicode-Zeichenfolge im virtuellen Adressraum des Ziels.	Die angegebene Zeichenfolge.
%msa	ULONG64	Die Adresse einer ANSI_STRING Struktur im virtuellen Adressraum des Ziels.	Die angegebene Zeichenfolge.
%msu	ULONG64	Die Adresse einer UNICODE_STRING-Struktur im virtuellen Adressraum des Ziels.	Die angegebene Zeichenfolge.
%y	ULONG64	Die Adresse eines Debuggersymbols im virtuellen Adressraum des Ziels.	Eine Zeichenfolge, die den Namen des angegebenen Symbols (und ggf. Verschiebung) enthält.
%ly	ULONG64	Die Adresse eines Debuggersymbols im virtuellen Adressraum des Ziels.	Eine Zeichenfolge, die den Namen des angegebenen Symbols (und ggf. Verschiebung) sowie alle verfügbaren Quellzeileninformationen enthält.

Argumente
Gibt Argumente für die Formatzeichenfolge an, wie in printf. Die Anzahl der angegebenen Argumente sollte mit der Anzahl der Konvertierungszeichen in FormatString übereinstimmen. Jedes Argument ist ein Ausdruck, der vom Standardauswertungsauswerter (MASM oder C++) ausgewertet wird. Ausführliche Informationen finden Sie unter Syntax für numerische Ausdrücke.

Zusätzliche Informationen

Informationen zu anderen Ablaufsteuerungstoken und deren Verwendung in Debuggerbefehlsprogrammen finden Sie unter Verwenden von Debuggerbefehlsprogrammen.

Hinweise

Die Farbeinstellungen, die Sie mithilfe des Optionsparameters auswählen können, sind standardmäßig auf schwarzen Text auf weißem Hintergrund festgelegt. Um diese Optionen optimal nutzen zu können, müssen Sie zuerst Ansicht | Optionen zum Öffnen des Dialogfelds Optionen und Ändern der Farbeinstellungen für Meldungen im Debuggerbefehlsfenster.

Das folgende Beispiel zeigt, wie ein DML-Tag in die Formatzeichenfolge eingeschlossen wird.

.printf /D "Click <link cmd=\".chain /D\">here</link> to see extensions DLLs."

Die in der obigen Abbildung gezeigte Ausgabe enthält einen Link, auf den Sie klicken können, um den im <link> Tag angegebenen Befehl auszuführen. Die folgende Abbildung zeigt das Ergebnis des Klickens auf den Link.

Informationen zu DML-Tags finden Sie unter dml.doc im Installationsordner für Debugtools für Windows.