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

Статья
08/07/2023

Метод Disassemble дизассемблирует инструкцию процессора в памяти целевого объекта.

Синтаксис

HRESULT Disassemble(
  [in]            ULONG64  Offset,
  [in]            ULONG    Flags,
  [out, optional] PSTR     Buffer,
  [in]            ULONG    BufferSize,
  [out, optional] PULONG   DisassemblySize,
  [out]           PULONG64 EndOffset
);

Параметры

[in] Offset

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

[in] Flags

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

[out, optional] Buffer

Получает дизассемблированное инструкцию. Если параметр Buffer имеет значение NULL, эта информация не возвращается.

[in] BufferSize

Указывает размер буфера буфера буфера (в символах).

[out, optional] DisassemblySize

Получает размер разобранной инструкции в символах. Если disassemblySize имеет значение NULL, эти сведения не возвращаются.

[out] EndOffset

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

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

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

Код возврата	Описание
S_OK	Метод выполнен успешно.
S_FALSE	Метод выполнен успешно. Однако буфер был слишком мал, чтобы вместить дизассемблированную инструкцию, и инструкция была усечена.

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