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 |
從目前範圍的緩存器內容擷取緩存器資訊。
注意 Stack 回溯並不保證緩存器內容的正確更新,因此範圍框架的緩存器內容在所有情況下可能都不正確。
|
[in] Count
指定要設定值的緩存器數目。
[in, optional] Indices
指定數位,其中包含要為其設定值的緩存器索引。 此陣列中的元素數目 Count。 如果 索引NULL,則會改用 Start。
[in] Start
如果 索引NULL,則會從這個索引開始連續設定緩存器。 否則會忽略它。
[in] Values
陣列,其中包含要設定緩存器的值。 這個陣列保留的項目數目是 Count。 如需此參數類型的描述,請參閱 DEBUG_VALUE。
傳回值
此清單不包含可能發生的所有錯誤。 如需可能的錯誤清單,請參閱 HRESULT 值。
傳回碼 | 描述 |
---|---|
|
方法成功。 |
言論
引擎會盡最大努力將 Values 中的值轉換成緩存器類型;此轉換與 CoerceValue所執行的轉換相同。 如果值大於緩存器可以保留的值,則會卸除最小有效位。 如有必要,也會執行浮點和整數轉換。
如果傳回值未S_OK,部分緩存器可能仍可能已設定。
變更子登錄時,也會改變包含它的緩存器。
setValues 方法 執行與此方法相同的工作,但一律會使用目標做為緩存器來源。
如需 IDebugRegisters 介面和其他註冊相關方法的概觀,請參閱 Registers。
要求
要求 | 價值 |
---|---|
目標平臺 | 桌面 |
標頭 | dbgeng.h (include DbgEng.h) |