IDebugDisassemblyStream2::Seek

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

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 IDebugDisassemblyStream2::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

Reference

IDebugDisassemblyStream2

SEEK_START

IDebugCodeContext2

IDebugDisassemblyStream2::GetCodeLocationId