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

Artículo
08/07/2023

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

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, consulte 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 mostrarla.
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 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.

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.

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.