Share via


IDebugDisassemblyStream2::Seek

Note

This article applies to Visual Studio 2015. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here

Moves the read pointer in the disassembly stream a given number of instructions relative to a specified position.

Syntax

HRESULT Seek(   
   SEEK_START          dwSeekStart,  
   IDebugCodeContext2* pCodeContext,  
   UINT64              uCodeLocationId,  
   INT64               iInstructions  
);  
int Seek(   
   enum_SEEK_START    dwSeekStart,  
   IDebugCodeContext2 pCodeContext,  
   ulong              uCodeLocationId,  
   long               iInstructions  
);  

Parameters

dwSeekStart
[in] A value from the SEEK_START enumeration that specifies the relative position to begin the seek process.

pCodeContext
[in] The IDebugCodeContext2 object representing the code context that the seek operation is relative to. This parameter is used only if dwSeekStart = SEEK_START_CODECONTEXT; otherwise, this parameter is ignored and can be a null value.

uCodeLocationId
[in] The code location identifier that the seek operation is relative to. This parameter is used if dwSeekStart = SEEK_START_CODELOCID; otherwise, this parameter is ignored and can be set to 0. See the Remarks section for the GetCodeLocationId method for a description of a code location identifier.

iInstructions
[in] The number of instructions to move relative to the position specified in dwSeekStart. This value can be negative to move backwards.

Return Value

If successful, returns S_OK. Returns S_FALSE if the seek position was to a point beyond the list of available instructions. Otherwise, returns an error code.

Remarks

If the seek was to a position before the beginning of the list, the read position is set to the first instruction in the list. If the see was to a position after the end of the list, the read position is set to the last instruction in the list.

See Also

IDebugDisassemblyStream2
SEEK_START
IDebugCodeContext2
GetCodeLocationId