Метод IDebugControl::Assemble (dbgeng.h)

Метод Assemble собирает одну инструкцию процессора. Собранная инструкция помещается в память целевого объекта.

Синтаксис

HRESULT Assemble(
  [in]  ULONG64  Offset,
  [in]  PCSTR    Instr,
  [out] PULONG64 EndOffset
);

Параметры

[in] Offset

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

[in] Instr

Указывает инструкцию для сборки. Инструкция собирается в соответствии с эффективным типом процессора целевого объекта (возвращается SetEffectiveProcessorType).

[out] EndOffset

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

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

Код возврата	Описание
S_OK	Метод выполнен успешно.

 

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

Комментарии

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

Примечание Методы Assemble и AssembleWide не поддерживаются в некоторых архитектурах, а в некоторых других архитектурах поддерживаются не все инструкции.

 

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

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

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	dbgeng.h (включая Dbgeng.h)

См. также раздел

Разобрать

GetAssemblyOptions

IDebugControl

IDebugControl2

IDebugControl3