Método IDebugControl2::Assemble (dbgeng.h)

Artigo
02/23/2024

O método Assemble monta uma única instrução de processador. A instrução montada é colocada na memória do destino.

Sintaxe

HRESULT Assemble(
  [in]  ULONG64  Offset,
  [in]  PCSTR    Instr,
  [out] PULONG64 EndOffset
);

Parâmetros

[in] Offset

Especifica o local na memória do destino para colocar a instrução montada.

[in] Instr

Especifica a instrução a ser montada. A instrução é montada de acordo com o tipo de processador efetivo do destino (retornado por SetEffectiveProcessorType).

[out] EndOffset

Recebe o local na memória do destino imediatamente após a instrução montada. EndOffset pode ser usado ao montar várias instruções.

Retornar valor

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

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

Comentários

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

Nota Os métodos Assemble e AssembleWide não têm suporte em algumas arquiteturas e, em algumas outras arquiteturas, nem todas as instruções têm suporte.

As opções de linguagem do assembly, retornadas por GetAssemblyOptions, afetam a operação desse método.

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.