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

Статья
02/06/2025

Метод OutputDisassemblyLines удаляет несколько инструкций процессора и отправляет результирующий инструкции сборки обратных вызовов.

Синтаксис

HRESULT OutputDisassemblyLines(
  [in]            ULONG    OutputControl,
  [in]            ULONG    PreviousLines,
  [in]            ULONG    TotalLines,
  [in]            ULONG64  Offset,
  [in]            ULONG    Flags,
  [out, optional] PULONG   OffsetLine,
  [out, optional] PULONG64 StartOffset,
  [out, optional] PULONG64 EndOffset,
  [out, optional] PULONG64 LineOffsets
);

Параметры

[in] OutputControl

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

[in] PreviousLines

Указывает количество строк инструкций перед инструкцией в Offset для включения в выходные данные. Как правило, каждая инструкция выводится в одной строке. Однако некоторые инструкции могут занять несколько строк выходных данных; это может привести к тому, что количество выходных данных строк перед инструкцией в Offset будет больше PreviousLines.

[in] TotalLines

Указывает общее количество строк инструкций для включения в выходные данные. Как правило, каждая инструкция выводится в одной строке. Однако некоторые инструкции могут занять несколько строк выходных данных; это может привести к тому, что количество выходных данных строк больше TotalLines.

[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, optional] OffsetLine

Получает номер строки в выходных данных, содержащий инструкцию по Offset. Если OffsetLineNULL, эти сведения не возвращаются.

[out, optional] StartOffset

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

[out, optional] EndOffset

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

[out, optional] LineOffsets

Получает расположения в памяти целевого объекта инструкций, включенных в выходные данные, начиная с инструкции Offset. LineOffsets — это массив, содержащий элементы TotalLines.

Смещение — это значение первой записи в этом массиве, если только перед этой инструкцией не произошла ошибка. В этом случае первая запись будет содержать DEBUG_ANY_ID и смещение будет помещена во вторую запись в массиве (индекс один).

Если выходные данные инструкции охватывают несколько строк, элемент в массиве, соответствующий первой строке инструкции, будет содержать адрес инструкции.

Если LineOffsetsNULL, эти сведения не возвращаются.

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

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

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

Замечания

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

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