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

Статья
02/06/2025

Метод OutputDisassembly дизассемблирует инструкцию процессора и отправляет дизассембли в выходных вызовов.

Синтаксис

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

Параметры

[in] OutputControl

Указывает выходной элемент управления, определяющий, какие обратные вызовы клиента получают выходные данные. Возможные значения см. в разделе DEBUG_OUTCTL_XXX. Дополнительные сведения о выходных данных см. в входных и выходных данных.

[in] Offset

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

[in] Flags

Указывает битовые флаги, влияющие на поведение этого метода. В следующей таблице перечислены биты, которые можно задать.

Bit-Flag	Эффект при установке
DEBUG_DISASM_EFFECTIVE_ADDRESS	Вычислить действующий адрес из текущей информации о регистрации и отобразить его.
DEBUG_DISASM_MATCHING_SYMBOLS	Если адрес инструкции совпадает с точным символом, выводит символ.
DEBUG_DISASM_SOURCE_LINE_NUMBER	Включите исходный номер строки инструкции в выходные данные.
DEBUG_DISASM_SOURCE_FILE_NAME	Добавьте имя исходного файла в выходные данные.

[out] EndOffset

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

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

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

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

Замечания

Язык сборки зависит от эффективного типа процессора целевой системы. Сведения о языке сборки см. в документации по процессору.

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