Partager via


IDebugDisassemblyStream2 : : accès

Déplace le pointeur de lecture dans le flux de code machine un nombre donné d'instruction par rapport à la position spécifiée.

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

Paramètres

  • dwSeekStart
    [in] Une valeur de l'énumération de SEEK_START qui spécifie la position relative pour démarrer le processus d'accès.

  • pCodeContext
    [in] L'objet d' IDebugCodeContext2 représentant le contexte de code que l'opération de recherche est associée. Ce paramètre est utilisé uniquement si dwSeekStart = SEEK_START_CODECONTEXT; sinon, ce paramètre est ignoré et peut être une valeur NULL.

  • uCodeLocationId
    [in] L'identificateur de l'emplacement du code que l'opération de recherche est associée. Cette valeur est utilisée si dwSeekStart = SEEK_START_CODELOCID; sinon, ce paramètre est ignoré et peut avoir la valeur 0. Consultez la section Notes de la méthode d' IDebugDisassemblyStream2 : : GetCodeLocationId pour une description d'un identificateur d'emplacement du code.

  • iInstructions
    [in] Le nombre d'instructions de déplacer par rapport à la position spécifiée dans dwSeekStart. cette valeur peut être négative pour déplacer vers l'arrière.

Valeur de retour

En cas de réussite, retourne S_OK. Retourne S_FALSE si la position d'accès se trouvait à un point au delà de la liste d'instructions disponible. Sinon, retourne un code d'erreur.

Notes

Si l'accès est à une position avant le début de la liste, la position de lecture soit défini à la première instruction dans la liste. Si le voir était à une position après la fin de la liste, la position de lecture soit définie à la dernière instruction dans la liste.

Voir aussi

Référence

IDebugDisassemblyStream2

SEEK_START

IDebugCodeContext2

IDebugDisassemblyStream2 : : GetCodeLocationId