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

Статья
08/07/2023

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