Compartir a través de


Método IDebugControl::OutputDisassembly (dbgeng.h)

El método OutputDisassembly desensambla una instrucción de procesador y envía el desensamblaje a las devoluciones de llamada de salida de .

Sintaxis

HRESULT OutputDisassembly(
  [in]  ULONG    OutputControl,
  [in]  ULONG64  Offset,
  [in]  ULONG    Flags,
  [out] PULONG64 EndOffset
);

Parámetros

[in] OutputControl

Especifica el control de salida que determina qué devoluciones de llamada de salida del cliente reciben la salida. Para conocer los valores posibles, consulte DEBUG_OUTCTL_XXX. Para obtener más información sobre la salida, vea entrada y salida.

[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. En la tabla siguiente se enumeran los bits que se pueden establecer.

Bit-Flag Efecto cuando se establece
DEBUG_DISASM_EFFECTIVE_ADDRESS Calcule la dirección efectiva a partir de la información de registro actual y mostrándola.
DEBUG_DISASM_MATCHING_SYMBOLS Si la dirección de la instrucción tiene una coincidencia exacta de símbolos, genera el símbolo.
DEBUG_DISASM_SOURCE_LINE_NUMBER Incluya el número de línea de origen de la instrucción en la salida.
DEBUG_DISASM_SOURCE_FILE_NAME Incluya el nombre del archivo de origen en la salida.

[out] EndOffset

Recibe la ubicación en la memoria del destino de la instrucción que sigue a la instrucción desensambblada.

Valor devuelto

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

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

Observaciones

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.

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.

Requisitos

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

Consulte también

de desensamblar

IDebugControl

IDebugControl2

IDebugControl3

outputDisassemblyLines