.printf
El token .printf se comporta como la instrucción printf en C.
.printf [/D] [Option] "FormatString" [, Argument , ...]
Elementos de la sintaxis
/D
Especifica que la cadena de formato contiene el lenguaje de marcado del depurador (DML).
Opción
(Solo WinDbg) Especifica el tipo de mensaje de texto que WinDbg debe interpretar formatString como. WinDbg asigna cada tipo de mensaje de ventana de comando del depurador un fondo y un color de texto; Elegir una de estas opciones hace que el mensaje se muestre en los colores adecuados. El valor predeterminado es mostrar el texto como un mensaje de nivel normal.
Están disponibles las siguientes opciones.
| Opción | Tipo de mensaje | Título de colores en el cuadro de diálogo Opciones |
|---|---|---|
/od |
debuggee |
Ventana de comandos de nivel depurado |
/Od |
solicitud de depuración |
Ventana de comandos de nivel de símbolo del sistema debuggee |
/Π|
error |
Ventana de comandos de nivel de error |
/on |
normal |
Ventana de comandos de nivel normal |
/op |
símbolo del sistema |
Ventana de comandos de nivel de símbolo |
/Op |
registros de mensajes |
Ventana de comandos de nivel de registro del símbolo del sistema |
/os |
símbolos |
Ventana de comandos de nivel de mensaje de símbolo |
/Ov |
detallado |
Ventana de comandos de nivel detallado |
/Ow |
general, |
Ventana de comandos de nivel de advertencia |
FormatString
Especifica la cadena de formato, como en printf. En general, los caracteres de conversión funcionan exactamente como en C. Para los caracteres de conversión de punto flotante, el argumento de 64 bits se interpreta como un número de punto flotante de 32 bits a menos que se use el modificador l .
El modificador "I64" se puede agregar para indicar que un valor debe interpretarse como 64 bits. Por ejemplo, se puede usar "%I64x" para imprimir un número hexadecimal de 64 bits.
Se admite el carácter de conversión %p, pero representa un puntero en el espacio de direcciones virtuales del destino. No debe tener modificadores y usa el formato de dirección interna del depurador. Además de los especificadores de formato de estilo printf estándar, se admiten los siguientes caracteres de conversión adicionales.
| Carácter | Tipo de argumento | Argument | Texto impreso |
|---|---|---|---|
%p |
ULONG64 |
Puntero en el espacio de direcciones virtuales del destino. |
Valor del puntero. |
%N |
DWORD_PTR (32 o 64 bits, según la arquitectura del host) |
Puntero en el espacio de direcciones virtuales del host. |
Valor del puntero. (Esto equivale al carácter C %p estándar). |
%ma |
ULONG64 |
Dirección de una cadena ASCII terminada en NULL en el espacio de direcciones virtuales del destino. |
La cadena especificada. |
%mu |
ULONG64 |
Dirección de una cadena Unicode terminada en NULL en el espacio de direcciones virtuales del destino. |
La cadena especificada. |
%msa |
ULONG64 |
Dirección de una estructura de ANSI_STRING en el espacio de direcciones virtuales del destino. |
La cadena especificada. |
%msu |
ULONG64 |
Dirección de una estructura de UNICODE_STRING en el espacio de direcciones virtuales del destino. |
La cadena especificada. |
%y |
ULONG64 |
Dirección de un símbolo del depurador en el espacio de direcciones virtuales del destino. |
Cadena que contiene el nombre del símbolo especificado (y desplazamiento, si existe). |
%ly |
ULONG64 |
Dirección de un símbolo del depurador en el espacio de direcciones virtuales del destino. |
Cadena que contiene el nombre del símbolo especificado (y desplazamiento, si existe), así como cualquier información de línea de origen disponible. |
Argumentos
Especifica argumentos para la cadena de formato, como en printf. El número de argumentos especificados debe coincidir con el número de caracteres de conversión en FormatString. Cada argumento es una expresión que se evaluará mediante el evaluador de expresiones predeterminado (MASM o C++). Para obtener más detalles, consulte Sintaxis de expresiones numéricas.
Información adicional
Para obtener información sobre otros tokens de flujo de control y su uso en programas de comandos del depurador, consulte Uso de programas de comandos del depurador.
Comentarios
La configuración de color que puede elegir mediante el parámetro Options está establecida de forma predeterminada en texto negro en un fondo blanco. Para aprovechar mejor estas opciones, primero debe usar Ver | Opciones para abrir el cuadro de diálogo Opciones y cambiar la configuración de color de los mensajes de la ventana Comando del depurador.
En el ejemplo siguiente se muestra cómo incluir una etiqueta DML en la cadena de formato.
.printf /D "Click <link cmd=\".chain /D\">here</link> to see extensions DLLs."
La salida que se muestra en la imagen anterior tiene un vínculo que puede hacer clic para ejecutar el comando especificado en la <link> etiqueta . En la imagen siguiente se muestra el resultado de hacer clic en el vínculo.
Para obtener información sobre las etiquetas DML, consulte dml.doc en la carpeta de instalación para Herramientas de depuración para Windows.