.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 que o WinDbg deve interpretar o FormatString como. O WinDbg atribui a cada tipo de mensagem da janela de Comando do Depurador uma cor de fundo e texto; A escolha de 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 |
depurador |
Janela de comando do nível do depurador |
/Od |
prompt de depuração |
Janela de comando do nível do prompt do depurador |
/Π|
error |
Janela de comando de nível de erro |
/on |
normal |
Janela de comando de nível normal |
/op |
prompt |
Janela de comando de nível de prompt |
/Op |
registros de prompt |
Janela de comando de nível de registros de prompt |
/os |
símbolos |
Janela de comando do nível da mensagem do símbolo |
/Ov |
verbose |
Janela de comando de nível detalhado |
/Ow |
geral |
Janela de comando do 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.
O caractere de conversão %p é suportado, mas representa um ponteiro no espaço de endereço virtual do destino. Ele não deve ter nenhum modificador e usa a formatação de endereço interno do depurador. Além dos especificadores de formato padrão no estilo printf, 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 do 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). |
% |
ULONG64 |
O endereço de um símbolo do 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, confira Sintaxe de expressão numérica.
Informações Adicionais
Para saber mais sobre outros tokens de fluxo de controle e o uso em programas de comando do depurador, confira Usar programas de comando do depurador.
Comentários
As configurações de cor que você pode escolher usando o parâmetro Opções são, por padrão, todas definidas como texto preto em um plano de fundo branco. Para fazer o melhor uso dessas opções, você deve primeiro 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 no qual 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 das Ferramentas de Depuração para Windows.