Debugging Tools for Windows |
The GetInstructionOffset2 method returns the location of the current thread's current instruction.
HRESULT
IDebugRegisters2::GetInstructionOffset2(
IN ULONG Source,
OUT PULONG64 Offset
);
The possible values are listed in the following table.
Value | Register source |
---|---|
DEBUG_REGSRC_DEBUGGEE | Fetch register information from the target. |
DEBUG_REGSRC_EXPLICIT | Fetch register information from the current explicit register context. |
DEBUG_REGSRC_FRAME | Fetch register information from the current scope's register context. Note Stack unwinding does not guarantee accurate updating of the register context, so the scope frame's register context might not be accurate in all cases. |
This list does not contain all the errors that might occur. For a list of possible errors, see HRESULT Values.
GetInstructionOffset2 is available in IDebugRegisters2 and later versions.
The meaning of the value that is returned by this method is architecture-dependent. In particular, for an Itanium-based processor, the virtual address that is returned can indicate an address within a bundle.
The method GetInstructionOffset performs the same task as this method but always uses the target as the register source.
For an overview of the IDebugRegisters interface and other register-related methods, see Registers.
Headers: Defined in DbgEng.h. Include DbgEng.h.