Метод IDebugControl2::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 требуемое расположение инструкции может быть не определено однозначно. В этом случае отладчик будет выполнять поиск в обратном направлении со смещения до тех пор, пока не обнаружит расположение таким образом, чтобы между этим расположением и Смещением не было разностного числа инструкций.

Требования

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