Método IDebugControl3::GetNearInstruction (dbgeng.h)

  • Artículo

El método GetNearInstruction devuelve la ubicación de una instrucción de procesador relativa a una ubicación determinada.

Sintaxis

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

Parámetros

[in] Offset

Especifica la ubicación en el espacio de direcciones virtuales del proceso desde el que empezar a buscar la instrucción deseada.

[in] Delta

Especifica el número de instrucciones de Desplazamiento de la instrucción deseada. Si Delta es negativo, el desplazamiento devuelto es anterior a Offset (vea la sección Comentarios para obtener más información).

[out] NearOffset

Recibe la ubicación en el espacio de direcciones virtuales del proceso de la instrucción que es instrucciones delta fuera de Offset.

Valor devuelto

Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto Descripción
S_OK
 Método realizado correctamente.

Comentarios

En algunas arquitecturas, como x86 y x64, el tamaño de una instrucción puede variar. En estas arquitecturas, cuando Delta es negativo, es posible que la ubicación de instrucción deseada no se defina de forma única. En este caso, el motor del depurador buscará hacia atrás desde Offset hasta que encuentre una ubicación de modo que haya el número delta de instrucciones entre esa ubicación y Offset.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado dbgeng.h (incluir Dbgeng.h)