Поделиться через

Метод IDebugRegisters2::SetValues2 (dbgeng.h)

  • Статья

Метод SetValues2 задает значение нескольких регистров целевого объекта.

Синтаксис

HRESULT SetValues2(
  [in]           ULONG        Source,
  [in]           ULONG        Count,
  [in, optional] PULONG       Indices,
  [in]           ULONG        Start,
  [in]           PDEBUG_VALUE Values
);

Параметры

[in] Source

Указывает источник регистрации для запроса.

Возможные значения перечислены в следующей таблице.

Значение Регистрация источника
DEBUG_REGSRC_DEBUGGEE Получение сведений о регистрации из целевого объекта.
DEBUG_REGSRC_EXPLICIT Получение сведений о регистре из текущего явного контекста регистра.
DEBUG_REGSRC_FRAME Получение сведений о регистре из текущего контекста регистрации область.
Примечание Очистка стека не гарантирует точное обновление контекста регистра, поэтому контекст регистра кадра область может быть точным не во всех случаях.
 

[in] Count

Указывает количество регистров, для которых необходимо задать значения.

[in, optional] Indices

Указывает массив, содержащий индексы регистров, для которых задаются значения. Число элементов в этом массиве равно Count. Если параметр Индексы имеет значение NULL, вместо него используется start .

[in] Start

Если значение Indexs равно NULL, регистры будут задаваться последовательно, начиная с этого индекса. В других случаях он игнорируется.

[in] Values

Массив, содержащий значения, для которых необходимо задать регистры. Число элементов, которые содержит этот массив, равно Count. Описание этого типа параметров см. в DEBUG_VALUE .

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

Этот список не содержит всех ошибок, которые могут возникнуть. Список возможных ошибок см. в разделе Значения HRESULT.

Код возврата Описание
S_OK
 Метод выполнен успешно.

Комментарии

Подсистема делает все возможное для приведения значений в значениях к типу регистров; это преобразование совпадает с преобразованием CoerceValue. Если значение больше, чем то, что может хранить регистр, удаляются наименее значимые биты. При необходимости также будут выполняться преобразования с плавающей запятой и целыми числами.

Если возвращаемое значение не S_OK, некоторые регистры все еще могут быть заданы.

При изменении подрегистрастра также изменяется регистр, содержащий его.

Метод SetValues выполняет ту же задачу, что и этот метод, но всегда использует целевой объект в качестве источника регистра.

Общие сведения об интерфейсе IDebugRegisters и других методах , связанных с регистрами, см. в разделе Registers.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть dbgeng.h (включая DbgEng.h)

См. также раздел

IDebugRegisters2

SetValue

SetValues