Метод IDebugControl3::SetAssemblyOptions (dbgeng.h)

Статья
02/06/2025

Метод setAssemblyOptions задает параметры сборки и дизассембли, влияющие на то, как модуль отладчика собирает и дизассемблирует инструкции процессора для целевого объекта.

Синтаксис

HRESULT SetAssemblyOptions(
  [in] ULONG Options
);

Параметры

[in] Options

Задает новые параметры сборки и дизассембли, которые будут использоваться подсистемой отладчика . параметры — это битовое значение; он заменит существующие параметры сборки и дизассембли. Возможные значения см. в разделе "Примечания". DEBUG_ASMOPT_DEFAULT можно использовать для задания параметров по умолчанию.

Возвращаемое значение

Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в возвращаемых значений.

Возвращаемый код	Описание
S_OK	Метод был успешным.

Замечания

Дополнительные сведения об использовании сборки с API обработчика отладчика см. в инструкциях по сборке и расзаписи.

Параметры сборки и дизассемблирования влияют на то, как подсистема отладчика собирает и дизассемблирует инструкции процессора для целевого объекта.

Параметры представлены набором битов со следующими битами флагов.

Постоянный	Описание
DEBUG_ASMOPT_VERBOSE	При установке этого бита дополнительные сведения включаются в дизассембли. Это эквивалентно параметру подробного в команде .asm.
DEBUG_ASMOPT_NO_CODE_BYTES	Если этот бит задан, необработанные байты инструкции не включаются в дизассембли. Это эквивалентно параметру no_code_bytes в команде .asm.
DEBUG_ASMOPT_IGNORE_OUTPUT_WIDTH	Если этот бит задан, отладчик игнорирует ширину вывода при форматировании инструкций во время дизассембли. Это эквивалентно параметру ignore_output_width в команде .asm.
DEBUG_ASMOPT_SOURCE_LINE_NUMBER	При установке этого бита каждая строка выходных данных дизассембли префиксируется номером строки исходного кода, предоставленного сведениями о символах. Это эквивалентно параметру source_line в команде .as.

Кроме того, значение DEBUG_ASMOPT_DEFAULT представляет набор параметров сборки и дизассембли по умолчанию. Это означает, что все параметры в предыдущей таблице отключены.