.Printf

Il token printf si comporta come l'istruzione printf in C.

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

Elementi della sintassi

/D
Specifica che la stringa di formato contiene Debugger Markup Language (DML).

Opzione
(solo WinDbg) Specifica il tipo di messaggio di testo che WinDbg deve interpretare FormatString come. WinDbg assegna ogni tipo di messaggio della finestra di comando del debugger a un colore di sfondo e di testo; scegliendo una di queste opzioni, il messaggio verrà visualizzato nei colori appropriati. L'impostazione predefinita consiste nel visualizzare il testo come messaggio di livello normale.

Sono disponibili le seguenti opzioni.

Opzione	Tipo del messaggio	Titolo dei colori nella finestra di dialogo Opzioni
/od	debug	Finestra di comando a livello di debug
/oD	Richiesta di debug	Finestra di comando a livello di prompt del debug
/Oe	error	Finestra di comando a livello di errore
/on	normale	Finestra di comando a livello normale
/Op	prompt	Finestra di comando a livello di prompt
/Op	registri richieste	Prompt registra la finestra di comando a livello
/OS	simboli	Finestra di comando a livello di messaggio simbolo
/Ov	verbose	Finestra di comando livello dettagliato
/Ow	warning	Finestra di comando del livello di avviso

Formatstring
Specifica la stringa di formato, come in printf. In generale, i caratteri di conversione funzionano esattamente come in C. Per i caratteri di conversione a virgola mobile, l'argomento a 64 bit viene interpretato come numero a virgola mobile a 32 bit, a meno che non venga usato il modificatore l .

Il modificatore "I64" può essere aggiunto per indicare che un valore deve essere interpretato come 64 bit. Ad esempio, "%I64x" può essere usato per stampare un numero esadecimale a 64 bit.

Il carattere di conversione %p è supportato, ma rappresenta un puntatore nello spazio indirizzi virtuale della destinazione. Non deve avere modificatori e usa la formattazione degli indirizzi interni del debugger. Oltre agli identificatori di formato di tipo printf standard, sono supportati i caratteri di conversione aggiuntivi seguenti.

Carattere	Tipo di argomento	Argomento	Testo stampato
%p	ULONG64	Puntatore nello spazio indirizzi virtuale della destinazione.	Valore del puntatore.
%N	DWORD_PTR (32 o 64 bit, a seconda dell'architettura dell'host)	Puntatore nello spazio indirizzi virtuale dell'host.	Valore del puntatore. Equivale al carattere C %p standard.
%ma	ULONG64	Indirizzo di una stringa ASCII con terminazione NULL nello spazio indirizzi virtuali della destinazione.	Stringa specificata
%mu	ULONG64	Indirizzo di una stringa Unicode con terminazione NULL nello spazio indirizzi virtuali della destinazione.	Stringa specificata
%msa	ULONG64	Indirizzo di una struttura ANSI_STRING nello spazio indirizzi virtuale della destinazione.	Stringa specificata
%msu	ULONG64	Indirizzo di una struttura UNICODE_STRING nello spazio indirizzi virtuale della destinazione.	Stringa specificata
%y	ULONG64	Indirizzo di un simbolo del debugger nello spazio indirizzi virtuale della destinazione.	Stringa contenente il nome del simbolo specificato (e spostamento, se presente).
%ly	ULONG64	Indirizzo di un simbolo del debugger nello spazio indirizzi virtuale della destinazione.	Stringa contenente il nome del simbolo specificato (e lo spostamento, se presente), nonché eventuali informazioni sulla riga di origine disponibili.

Argomenti
Specifica gli argomenti per la stringa di formato, come in printf. Il numero di argomenti specificati deve corrispondere al numero di caratteri di conversione in FormatString. Ogni argomento è un'espressione che verrà valutata dall'analizzatore di espressioni predefinito (MASM o C++). Per informazioni dettagliate, vedere Sintassi delle espressioni numeriche.

Informazioni aggiuntive

Per informazioni su altri token del flusso di controllo e sul relativo uso nei programmi di comando del debugger, vedere Uso dei programmi di comando del debugger.

Commenti

Per impostazione predefinita, le impostazioni dei colori che è possibile scegliere utilizzando il parametro Options sono impostate su testo nero su uno sfondo bianco. Per usare al meglio queste opzioni, è prima necessario usare View | Opzioni per aprire la finestra di dialogo Opzioni e modificare le impostazioni dei colori per i messaggi della finestra di comando del debugger.

Nell'esempio seguente viene illustrato come includere un tag DML nella stringa di formato.

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

L'output visualizzato nell'immagine precedente ha un collegamento che è possibile fare clic per eseguire il comando specificato nel <link> tag. L'immagine seguente mostra il risultato del clic sul collegamento.

Per informazioni sui tag DML, vedere dml.doc nella cartella di installazione per Gli strumenti di debug per Windows.