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

Artículo
02/23/2024

El método Desensambla una instrucción de procesador en la memoria del destino.

Sintaxis

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 la ubicación en la memoria del destino de la instrucción que se va a desensamblar.

[in] Flags

Especifica las marcas de bits que afectan al comportamiento de este método. Actualmente, la única marca que se puede establecer es DEBUG_DISASM_EFFECTIVE_ADDRESS; cuando se establece, el motor calculará la dirección efectiva a partir de la información de registro actual y la mostrará.

[out, optional] Buffer

Recibe la instrucción desensamblada. Si Buffer es NULL, no se devuelve esta información.

[in] BufferSize

Especifica el tamaño, en caracteres, del búfer de búfer .

[out, optional] DisassemblySize

Recibe el tamaño, en caracteres, de la instrucción desensamblada. Si DesensambladoSize es NULL, esta información no se devuelve.

[out] EndOffset

Recibe la ubicación en la memoria del destino de la instrucción después de la instrucción desensamblada.

Valor devuelto

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

Código devuelto	Descripción
S_OK	Método realizado correctamente.
S_FALSE	Método realizado correctamente. Sin embargo, el búfer era demasiado pequeño para contener la instrucción desensamblada y la instrucción se truncaba para ajustarse.

Comentarios

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

Las opciones de desensamblaje devueltos por GetAssemblyOptions afectan al funcionamiento de este método.

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