Share via

IDebugDisassemblyStream2::Seek

  • Статья

Перемещает указатель чтения в потоке дизассембли заданное количество инструкций относительно указанной позиции.

Синтаксис

int Seek( 
   enum_SEEK_START    dwSeekStart,
   IDebugCodeContext2 pCodeContext,
   ulong              uCodeLocationId,
   long               iInstructions
);

Параметры

dwSeekStart
[in] Значение из перечисления SEEK_START , указывающее относительную позицию для начала процесса поиска.

pCodeContext
[in] Объект IDebugCodeContext2 , представляющий контекст кода, к которому относится операция поиска. Этот параметр используется только в том случае, если dwSeekStart = SEEK_START_CODECONTEXT; в противном случае этот параметр игнорируется и может быть значением NULL.

uCodeLocationId
[in] Идентификатор расположения кода, к которому относится операция поиска. Этот параметр используется, если dwSeekStart = SEEK_START_CODELOCID; в противном случае этот параметр игнорируется и может иметь значение 0. Описание идентификатора расположения кода см. в разделе "Примечания" для метода GetCodeLocationId .

iInstructions
[in] Число инструкций для перемещения относительно позиции, указанной в dwSeekStart. Это значение может быть отрицательным для перемещения назад.

Возвращаемое значение

В случае успеха возвращает S_OK. Возвращает, S_FALSE если позиция поиска была точкой за пределами списка доступных инструкций. В противном случае возвращается код ошибки.

Замечания

Если поиск был расположен перед началом списка, позиция чтения устанавливается в первую инструкцию в списке. Если в списке отображается позиция после окончания списка, позиция чтения устанавливается на последнюю инструкцию в списке.

См. также