Udostępnij za pośrednictwem

IDebugDisassemblyStream2::Seek

  • Artykuł

Przenosi wskaźnik odczytu w strumieniu dezasemblacji określoną liczbę instrukcji względem określonej pozycji.

Składnia

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

Parametry

dwSeekStart
[in] Wartość z wyliczenia SEEK_START , która określa położenie względne, aby rozpocząć proces wyszukiwania.

pCodeContext
[in] Obiekt IDebugCodeContext2 reprezentujący kontekst kodu, z którego jest względna operacja wyszukiwania. Ten parametr jest używany tylko wtedy, gdy dwSeekStart = SEEK_START_CODECONTEXT; w przeciwnym razie ten parametr jest ignorowany i może być wartością null.

uCodeLocationId
[in] Identyfikator lokalizacji kodu, z którą jest wykonywana operacja wyszukiwania. Ten parametr jest używany, jeśli dwSeekStart = SEEK_START_CODELOCID; w przeciwnym razie ten parametr jest ignorowany i można ustawić wartość 0. Zobacz sekcję Uwagi dla metody GetCodeLocationId , aby zapoznać się z opisem identyfikatora lokalizacji kodu.

iInstructions
[in] Liczba instrukcji, które mają być przenoszone względem pozycji określonej w dwSeekStart. Ta wartość może być ujemna, aby przejść do tyłu.

Wartość zwracana

Jeśli operacja powiedzie się, zwraca wartość S_OK. Zwraca wartość S_FALSE , jeśli pozycja wyszukiwania miała punkt poza listą dostępnych instrukcji. W przeciwnym razie zwraca kod błędu.

Uwagi

Jeśli wyszukiwanie miało miejsce przed rozpoczęciem listy, pozycja odczytu jest ustawiona na pierwszą instrukcję na liście. Jeśli pozycja see miała pozycję po końcu listy, pozycja odczytu jest ustawiona na ostatnią instrukcję na liście.

Zobacz też