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

El método Ensamblar ensambla una sola 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 de 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 en la memoria del destino inmediatamente después de la instrucción ensamblada. EndOffset se pueden usar al ensamblar varias instrucciones.

Valor devuelto

Código devuelto	Descripción
S_OK	El método se realizó correctamente.

 

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

Observaciones

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 ensamblado de 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 de , consulte Instrucciones de montaje y desensamblado.

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	dbgeng.h (include Dbgeng.h)

Consulte también

de desensamblar

GetAssemblyOptions

IDebugControl

IDebugControl2

IDebugControl3