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

Метод GetNearInstruction возвращает расположение инструкции процессора относительно заданного расположения.

Синтаксис

HRESULT GetNearInstruction(
  [in]  ULONG64  Offset,
  [in]  LONG     Delta,
  [out] PULONG64 NearOffset
);

Параметры

[in] Offset

Указывает расположение в виртуальном адресном пространстве процесса, с которого следует начать поиск нужной инструкции.

[in] Delta

Указывает количество инструкций из смещения нужной инструкции. Если значение Delta отрицательное, возвращается смещение до смещения (дополнительные сведения см. в разделе Примечания).

[out] NearOffset

Получает расположение в виртуальном адресном пространстве процесса инструкции, которая является разностными инструкциями, от смещения.

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

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

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

Комментарии

В некоторых архитектурах, таких как x86 и x64, размер инструкции может отличаться. В этих архитектурах, если значение Delta отрицательное, нужное расположение инструкций может не быть уникальным. В этом случае отладчик будет выполнять поиск в обратном направлении со смещения, пока не обнаружит расположение таким образом, чтобы между этим расположением и offset существовало разностное число инструкций.

Требования

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