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

Artículo
08/07/2023

El método SetAssemblyOptions establece las opciones de ensamblado y desensamblado que afectan a cómo el motor del depurador ensambla y desensambla el procesador para el destino.

Sintaxis

HRESULT SetAssemblyOptions(
  [in] ULONG Options
);

Parámetros

[in] Options

Especifica las nuevas opciones de ensamblado y desensamblado que usará el motor del depurador. Las opciones son un conjunto de bits; reemplazará las opciones de ensamblado y desensamblado existentes. Para obtener los valores posibles, vea Comentarios. DEBUG_ASMOPT_DEFAULT se puede usar para establecer las opciones predeterminadas.

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

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

Las opciones de ensamblado y desensamblado afectan a cómo el motor del depurador ensambla y desensambla el procesador para el destino.

Las opciones se representan mediante un conjunto de bits con las marcas de bits siguientes.

Constante	Descripción
DEBUG_ASMOPT_VERBOSE	Cuando se establece este bit, se incluye información adicional en el desensamblado. Esto equivale a la opción detallada en el comando .asm .
DEBUG_ASMOPT_NO_CODE_BYTES	Cuando se establece este bit, los bytes sin procesar de una instrucción no se incluyen en el desensamblado. Esto equivale a la opción no_code_bytes en el comando .asm .
DEBUG_ASMOPT_IGNORE_OUTPUT_WIDTH	Cuando se establece este bit, el depurador omite el ancho de la presentación de salida al dar formato a las instrucciones durante el desensamblado. Esto equivale a la opción ignore_output_width en el comando .asm .
DEBUG_ASMOPT_SOURCE_LINE_NUMBER	Cuando se establece este bit, cada línea de la salida de desensamblado tiene como prefijo el número de línea del código fuente proporcionado por la información de símbolos. Esto equivale a la opción source_line en el comando .asm .

Además, el valor DEBUG_ASMOPT_DEFAULT representa el conjunto predeterminado de opciones de ensamblado y desensamblado. Esto significa que todas las opciones de la tabla anterior están desactivadas.