.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."
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.
Per informazioni sui tag DML, vedere dml.doc nella cartella di installazione per Strumenti di debug per Windows.