Метод 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
Получает расположение в памяти целевого объекта инструкции, следующей за дизассемблированной инструкцией.
Возвращаемое значение
Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в разделе Возвращаемые значения .
Код возврата | Описание |
---|---|
|
Метод выполнен успешно. |
Комментарии
Язык ассемблера зависит от эффективного типа процессора целевой системы. Сведения о языке ассемблера см. в документации по процессору.
Общие сведения об использовании сборки в приложениях отладчика см. в разделе Отладка в режиме сборки. Дополнительные сведения об использовании сборки с API обработчика отладчика см. в разделе Инструкции по сборке и дизассембле.
Требования
Требование | Значение |
---|---|
Целевая платформа | Персональный компьютер |
Верхняя часть | dbgeng.h (включая Dbgeng.h) |