Método IDebugControl3::OutputDisassembly (dbgeng.h)

Artigo
02/26/2024

O método OutputDisassembly desmonta uma instrução do processador e envia o desmontagem para os retornos de chamada de saída.

Sintaxe

HRESULT OutputDisassembly(
  [in]  ULONG    OutputControl,
  [in]  ULONG64  Offset,
  [in]  ULONG    Flags,
  [out] PULONG64 EndOffset
);

Parâmetros

[in] OutputControl

Especifica o controle de saída que determina quais retornos de chamada de saída do cliente recebem a saída. Para obter valores possíveis, consulte DEBUG_OUTCTL_XXX. Para obter mais informações sobre saída, consulte Entrada e Saída.

[in] Offset

Especifica o local na memória do destino da instrução a ser desmontada.

[in] Flags

Especifica os sinalizadores de bit que afetam o comportamento desse método. A tabela a seguir lista os bits que podem ser definidos.

Bit-Flag	Efeito quando definido
DEBUG_DISASM_EFFECTIVE_ADDRESS	Compute o endereço efetivo das informações de registro atuais e exiba-o.
DEBUG_DISASM_MATCHING_SYMBOLS	Se o endereço da instrução tiver uma correspondência exata de símbolo, gere o símbolo.
DEBUG_DISASM_SOURCE_LINE_NUMBER	Inclua o número da linha de origem da instrução na saída.
DEBUG_DISASM_SOURCE_FILE_NAME	Inclua o nome do arquivo de origem na saída.

[out] EndOffset

Recebe o local na memória do destino da instrução que segue a instrução desmontada.

Retornar valor

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.

Comentários

A linguagem do assembly depende do tipo de processador efetivo do sistema de destino. Para obter informações sobre o idioma do assembly, consulte a documentação do processador.

Para obter uma visão geral do uso do assembly em aplicativos do depurador, consulte Depuração no modo assembly. Para obter mais informações sobre como usar o assembly com a API do mecanismo de depurador, consulte Instruções de montagem e desmontagem.