.Printf

El token .printf se comporta como la instrucción printf en C.

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

Elementos de 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 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 opciones siguientes:

Opción	Tipo de mensaje	Título de colores en el cuadro de diálogo Opciones
/od	debuggee	Ventana de comandos de nivel de depuración
/Od	símbolo del sistema de depuración	Ventana de comandos de nivel de símbolo del sistema debuggee
/Oe	error	Ventana de comandos de nivel de error
/on	normal	Ventana de comandos de nivel normal
/Op	símbolo del sistema	Ventana del comando de nivel de símbolo
/Op	registros del símbolo del sistema	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	verbose	Ventana de comandos de nivel detallado
/Ow	warning	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 se debe interpretar 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 ningún modificador 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	Argumento	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 estándar de C %p).
%ma	ULONG64	Dirección de una cadena ASCII terminada en NULL en el espacio de direcciones virtuales del destino.	Cadena especificada.
%mu	ULONG64	Dirección de una cadena Unicode terminada en NULL en el espacio de direcciones virtuales del destino.	Cadena especificada.
%msa	ULONG64	Dirección de una estructura de ANSI_STRING en el espacio de direcciones virtuales del destino.	Cadena especificada.
%msu	ULONG64	Dirección de una estructura de UNICODE_STRING en el espacio de direcciones virtuales del destino.	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 más información, consulte Sintaxis de expresión numérica.

Información adicional

Para obtener información sobre otros tokens de flujo de control y su uso en programas de comandos del depurador, vea Using Debugger Command Programs.

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 View | 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, vea dml.doc en la carpeta de instalación de Herramientas de depuración para Windows.