IDebugDisassemblyStream2::SeekIDebugDisassemblyStream2::Seek

Déplace le pointeur de la lecture dans le flux de code machine un nombre donné d’instructions par rapport à une position spécifiée.Moves the read pointer in the disassembly stream a given number of instructions relative to a specified position.

SyntaxeSyntax

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

ParamètresParameters

dwSeekStart
[in] Une valeur à partir de la SEEK_START énumération qui spécifie la position relative pour commencer le processus de recherche.[in] A value from the SEEK_START enumeration that specifies the relative position to begin the seek process.

pCodeContext
[in] Le IDebugCodeContext2 objet représentant le contexte de code que l’opération de recherche est relatif au.[in] The IDebugCodeContext2 object representing the code context that the seek operation is relative to. Ce paramètre est utilisé uniquement si dwSeekStart = SEEK_START_CODECONTEXT; sinon, ce paramètre est ignoré et peut être une valeur null.This parameter is used only if dwSeekStart = SEEK_START_CODECONTEXT; otherwise, this parameter is ignored and can be a null value.

uCodeLocationId
[in] L’identificateur d’emplacement de code auquel l’opération de recherche est associée.[in] The code location identifier that the seek operation is relative to. Ce paramètre est utilisé si dwSeekStart = SEEK_START_CODELOCID; sinon, ce paramètre est ignoré et peut être défini à 0.This parameter is used if dwSeekStart = SEEK_START_CODELOCID; otherwise, this parameter is ignored and can be set to 0. Consultez la section Notes pour le GetCodeLocationId méthode pour obtenir une description d’un identificateur d’emplacement de code.See the Remarks section for the GetCodeLocationId method for a description of a code location identifier.

iInstructions
[in] Le nombre d’instructions pour déplacer par rapport à la position spécifiée dans dwSeekStart.[in] The number of instructions to move relative to the position specified in dwSeekStart. Cette valeur peut être négative revenir en arrière.This value can be negative to move backwards.

Valeur de retourReturn Value

En cas de réussite, retourne S_OK.If successful, returns S_OK. Retourne S_FALSE si la position de recherche a été au-delà de la liste des instructions disponibles.Returns S_FALSE if the seek position was to a point beyond the list of available instructions. Sinon, retourne un code d'erreur.Otherwise, returns an error code.

NotesRemarks

Si la recherche a été vers une position avant le début de la liste, la position de lecture est définie à la première instruction dans la liste.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. Si le consultez consistait à une position après la fin de la liste, la position de lecture est définie sur la dernière instruction dans la liste.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.

Voir aussiSee Also

IDebugDisassemblyStream2 IDebugDisassemblyStream2
SEEK_START SEEK_START
IDebugCodeContext2 IDebugCodeContext2
GetCodeLocationIdGetCodeLocationId