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

Artículo
08/07/2023

El método Assemble ensambla una única instrucción de procesador. La instrucción ensamblada se coloca en la memoria del destino.

Sintaxis

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

Parámetros

[in] Offset

Especifica la ubicación en la memoria del destino para colocar la instrucción ensamblada.

[in] Instr

Especifica la instrucción que se va a ensamblar. La instrucción se ensambla según el tipo de procesador efectivo del destino (devuelto por SetEffectiveProcessorType).

[out] EndOffset

Recibe la ubicación de la memoria del destino inmediatamente después de la instrucción ensamblada. EndOffset se puede usar al ensamblar varias instrucciones.

Valor devuelto

Código devuelto	Descripción
S_OK	Método realizado correctamente.

Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.

Comentarios

El lenguaje de ensamblado depende del tipo de procesador efectivo de la máquina de destino. Para obtener información sobre el lenguaje de ensamblado, consulte la documentación del procesador.

Nota Los métodos Assemble y AssembleWide no se admiten en algunas arquitecturas y en otras arquitecturas no se admiten todas las instrucciones.

Las opciones del lenguaje de ensamblado, devueltas por GetAssemblyOptions, afectan a la operación de este método.

Para obtener información general sobre el uso del ensamblado en aplicaciones del depurador, consulte Depuración en modo de ensamblado. Para obtener más información sobre el uso del ensamblado con la API del motor de depurador, consulte Instrucciones de montaje y desensamblado.