.Printf

O token .printf se comporta como a instrução printf em C.

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

Elementos de sintaxe

/D
Especifica que a cadeia de caracteres de formato contém DML ( Linguagem de Marcação do Depurador ).

Opção
(Somente WinDbg) Especifica o tipo de mensagem de texto como o qual WinDbg deve interpretar FormatString. O WinDbg atribui a cada tipo de mensagem de janela Comando do Depurador uma cor de texto e plano de fundo; escolher uma dessas opções faz com que a mensagem seja exibida nas cores apropriadas. O padrão é exibir o texto como uma mensagem de nível normal.

As opções a seguir estão disponíveis.

Opção	Tipo de mensagem	Título das cores na caixa de diálogo Opções
/od	Debuggee	Janela de comando de nível de depuração
/Od	prompt de depuração	Janela de comando de nível de prompt de depuração
/Oe	erro	Janela de comando de nível de erro
/on	normal	Janela de comando de nível normal
/op	prompt	Janela de comando no nível do prompt
/Op	registros de prompt	Janela de comando de nível de registros de prompt
/os	símbolos	Janela de comando de nível de mensagem de símbolo
/Ov	verbose	Janela de comando de nível detalhado
/Ow	warning	Janela de comando de nível de aviso

Formatstring
Especifica a cadeia de caracteres de formato, como em printf. Em geral, os caracteres de conversão funcionam exatamente como em C. Para os caracteres de conversão de ponto flutuante, o argumento de 64 bits é interpretado como um número de ponto flutuante de 32 bits, a menos que o modificador l seja usado.

O modificador "I64" pode ser adicionado para indicar que um valor deve ser interpretado como 64 bits. Por exemplo, "%I64x" pode ser usado para imprimir um número hexadecimal de 64 bits.

Há suporte para o caractere de conversão %p, mas representa um ponteiro no espaço de endereço virtual do destino. Ele não deve ter modificadores e usa a formatação de endereço interno do depurador. Além dos especificadores de formato de estilo printf padrão, há suporte para os seguintes caracteres de conversão adicionais.

Caractere	Tipo de argumento	Argumento	Texto impresso
%p	ULONG64	Um ponteiro no espaço de endereço virtual do destino.	O valor do ponteiro.
%N	DWORD_PTR (32 ou 64 bits, dependendo da arquitetura do host)	Um ponteiro no espaço de endereço virtual do host.	O valor do ponteiro. (Isso é equivalente ao caractere C %p padrão.)
%ma	ULONG64	O endereço de uma cadeia de caracteres ASCII terminada em NULL no espaço de endereço virtual do destino.	A cadeia de caracteres especificada.
%mu	ULONG64	O endereço de uma cadeia de caracteres Unicode terminada em NULL no espaço de endereço virtual do destino.	A cadeia de caracteres especificada.
%msa	ULONG64	O endereço de uma estrutura ANSI_STRING no espaço de endereço virtual do destino.	A cadeia de caracteres especificada.
%msu	ULONG64	O endereço de uma estrutura UNICODE_STRING no espaço de endereço virtual do destino.	A cadeia de caracteres especificada.
%y	ULONG64	O endereço de um símbolo de depurador no espaço de endereço virtual do destino.	Uma cadeia de caracteres que contém o nome do símbolo especificado (e deslocamento, se houver).
%ly	ULONG64	O endereço de um símbolo de depurador no espaço de endereço virtual do destino.	Uma cadeia de caracteres que contém o nome do símbolo especificado (e deslocamento, se houver), bem como qualquer informação de linha de origem disponível.

Argumentos
Especifica argumentos para a cadeia de caracteres de formato, como em printf. O número de argumentos especificados deve corresponder ao número de caracteres de conversão em FormatString. Cada argumento é uma expressão que será avaliada pelo avaliador de expressão padrão (MASM ou C++). Para obter detalhes, consulte Sintaxe de expressão numérica.

Informações adicionais

Para obter informações sobre outros tokens de fluxo de controle e seu uso em programas de comando do depurador, consulte Usando programas de comando do depurador.

Comentários

As configurações de cor que você pode escolher usando o parâmetro Options são, por padrão, definidas como texto preto em uma tela de fundo branca. Para fazer o melhor uso dessas opções, primeiro você deve usar Exibir | Opções para abrir a caixa de diálogo Opções e alterar as configurações de cor das mensagens da janela Comando do Depurador.

O exemplo a seguir mostra como incluir uma marca DML na cadeia de caracteres de formato.

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

A saída mostrada na imagem anterior tem um link que você pode clicar para executar o comando especificado na <link> marca. A imagem a seguir mostra o resultado de clicar no link.

Para obter informações sobre marcas DML, consulte dml.doc na pasta de instalação para Ferramentas de Depuração para Windows.