Поделиться через


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

Метод 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 обработчика отладчика см. в разделе Инструкции по сборке и дизассембле.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть dbgeng.h (включая Dbgeng.h)

См. также раздел

Разобрать

IDebugControl

IDebugControl2

IDebugControl3

OutputDisassemblyLines