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

Статья
02/06/2025

Метод 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

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

[in] BufferSize

Задает размер буфера в символах.

[out, optional] DisassemblySize

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

[out] EndOffset

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

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

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

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

Замечания

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

Параметры дизассемблирования, возвращаемые GetAssemblyOptions- влияют на работу этого метода.

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