Condividi tramite


.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 il linguaggio DML (Debugger Markup Language ).

Opzione
(solo WinDbg) Specifica il tipo di messaggio di testo che WinDbg deve interpretare FormatString come. WinDbg assegna ogni tipo di messaggio della finestra del comando debugger a un colore di sfondo e di testo; la scelta di una di queste opzioni determina la visualizzazione del messaggio nei colori appropriati. L'impostazione predefinita consiste nel visualizzare il testo come messaggio a 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

Errore

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 a 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 utilizza 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 virtuale 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 di 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é le 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.

Osservazioni:

Per impostazione predefinita, le impostazioni dei colori che è possibile scegliere utilizzando il parametro Options sono tutte 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."

Screenshot del collegamento DML nella finestra del browser dei comandi.

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

Screenshot dell'output DML nella finestra del browser dei comandi.

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