Método IDebugControl2::D isassemble (dbgeng.h)

Artigo
08/07/2023

O método Disassemble desmonta uma instrução de processador na memória do destino.

Sintaxe

HRESULT Disassemble(
  [in]            ULONG64  Offset,
  [in]            ULONG    Flags,
  [out, optional] PSTR     Buffer,
  [in]            ULONG    BufferSize,
  [out, optional] PULONG   DisassemblySize,
  [out]           PULONG64 EndOffset
);

Parâmetros

[in] Offset

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

[in] Flags

Especifica os sinalizadores de bits que afetam o comportamento desse método. Atualmente, o único sinalizador que pode ser definido é DEBUG_DISASM_EFFECTIVE_ADDRESS; quando definido, o mecanismo calculará o endereço efetivo das informações de registro atuais e o exibirá.

[out, optional] Buffer

Recebe a instrução desmontada. Se Buffer for NULL, essas informações não serão retornadas.

[in] BufferSize

Especifica o tamanho, em caracteres, do buffer de buffer .

[out, optional] DisassemblySize

Recebe o tamanho, em caracteres, da instrução desmontada. Se DisassemblySize for NULL, essas informações não serão retornadas.

[out] EndOffset

Recebe o local na memória do destino da instrução seguindo 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.
S_FALSE	O método foi bem-sucedido. No entanto, Buffer era muito pequeno para manter a instrução desmontada e a instrução foi truncada para caber.

Comentários

A linguagem de 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.

As opções de desmontagem — retornadas por GetAssemblyOptions — afetam a operação desse método.

Para obter uma visão geral do uso do assembly em aplicativos de depurador, consulte Depuração no Modo de 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.