Share via

IDebugDisassemblyStream2::Seek

  • Artículo

Mueve el puntero de lectura en el flujo de desensamblaje un número determinado de instrucciones relativas a una posición especificada.

Sintaxis

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

Parámetros

dwSeekStart
[in] Valor de la enumeración SEEK_START que especifica la posición relativa para iniciar el proceso de búsqueda.

pCodeContext
[in] Objeto IDebugCodeContext2 que representa el contexto de código al que se refiere la operación seek. Este parámetro solo se usa si dwSeekStart = SEEK_START_CODECONTEXT; de lo contrario, este parámetro se omite y puede ser un valor NULL.

uCodeLocationId
[in] Identificador de ubicación de código al que se refiere la operación seek. Este parámetro se usa si dwSeekStart = SEEK_START_CODELOCID; de lo contrario, este parámetro se omite y se puede establecer en 0. Consulte la sección Comentarios del método GetCodeLocationId para obtener una descripción de un identificador de ubicación de código.

iInstructions
[in] Número de instrucciones para mover en relación con la posición especificada en dwSeekStart. Este valor puede ser negativo para retroceder.

Valor devuelto

Si la operación se realiza correctamente, devuelve S_OK. Devuelve S_FALSE si la posición de búsqueda estaba en un punto más allá de la lista de instrucciones disponibles. De lo contrario, devuelve un código de error.

Comentarios

Si la búsqueda estaba en una posición antes del principio de la lista, la posición de lectura se establece en la primera instrucción de la lista. Si la vista estaba en una posición después del final de la lista, la posición de lectura se establece en la última instrucción de la lista.

Consulte también