Skip to content

Latest commit

 

History

History
92 lines (71 loc) · 3.37 KB

nf-dbgeng-idebugcontrol-getnearinstruction.md

File metadata and controls

92 lines (71 loc) · 3.37 KB
Raw
UID title description old-location tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames f1_keywords topic_type api_type api_location api_name
NF:dbgeng.IDebugControl.GetNearInstruction
IDebugControl::GetNearInstruction (dbgeng.h)
Learn how the GetNearInstruction method returns the location of a processor instruction relative to a given location.
debugger\getnearinstruction.htm
debugger
05/03/2018
IDebugControl::GetNearInstruction
GetNearInstruction, GetNearInstruction method [Windows Debugging], GetNearInstruction method [Windows Debugging],IDebugControl interface, GetNearInstruction method [Windows Debugging],IDebugControl2 interface, GetNearInstruction method [Windows Debugging],IDebugControl3 interface, IDebugControl interface [Windows Debugging],GetNearInstruction method, IDebugControl.GetNearInstruction, IDebugControl2 interface [Windows Debugging],GetNearInstruction method, IDebugControl2::GetNearInstruction, IDebugControl3 interface [Windows Debugging],GetNearInstruction method, IDebugControl3::GetNearInstruction, IDebugControl::GetNearInstruction, IDebugControl_2c12e1fe-0f9b-45d6-9ff4-477bc42b2275.xml, dbgeng/IDebugControl2::GetNearInstruction, dbgeng/IDebugControl3::GetNearInstruction, dbgeng/IDebugControl::GetNearInstruction, debugger.getnearinstruction
dbgeng.h
Dbgeng.h
Desktop
Windows
IDebugControl::GetNearInstruction
dbgeng/IDebugControl::GetNearInstruction
APIRef
kbSyntax
COM
dbgeng.h
IDebugControl::GetNearInstruction

IDebugControl::GetNearInstruction

-description

The GetNearInstruction method returns the location of a processor instruction relative to a given location.

-parameters

-param Offset [in]

Specifies the location in the process's virtual address space from which to start looking for the desired instruction.

-param Delta [in]

Specifies the number of instructions from Offset of the desired instruction. If Delta is negative, the returned offset is before Offset (see the Remarks section for more information).

-param NearOffset [out]

Receives the location in the process's virtual address space of the instruction that is Delta instructions away from Offset.

-returns

This method may also return error values. See Return Values for more details.

Return code Description
S_OK
 The method was successful.

-remarks

On some architectures, like x86 and x64, the size of an instruction may vary. On these architectures, when Delta is negative, the desired instruction location might not be uniquely defined. In this case, the debugger engine will search backward from Offset until it encounters a location such that there are the Delta number of instructions between that location and Offset.