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

Artigo
02/06/2025

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.

Valor de retorno

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 de Valores Retornados para obter mais detalhes.

Observações

O idioma 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.

Observação 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 de depurador, consulte Depuração no modo assembly. Para obter mais informações sobre como usar o assembly com o de API do mecanismo de depurador, consulte de Instruções de Montagem e Desmontagem.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	dbgeng.h (inclua Dbgeng.h)

Consulte também

desmontável

GetAssemblyOptions

IDebugControl

IDebugControl2

IDebugControl3

Compartilhar via