ICorDebugRegisterSet

更新：2007 年 11 月

表示目前在電腦上執行程式碼的可用暫存器集合。

interface ICorDebugRegisterSet : IUnknown {

    typedef enum CorDebugRegister {
        REGISTER_INSTRUCTION_POINTER = 0,
        REGISTER_STACK_POINTER,
                REGISTER_FRAME_POINTER,
                
        REGISTER_X86_EIP = 0,
        REGISTER_X86_ESP,
        REGISTER_X86_EBP,
                
        REGISTER_X86_EAX,
        REGISTER_X86_ECX,
        REGISTER_X86_EDX,
        REGISTER_X86_EBX,
                
        REGISTER_X86_ESI,
        REGISTER_X86_EDI,
                
        REGISTER_X86_FPSTACK_0,
        REGISTER_X86_FPSTACK_1,
        REGISTER_X86_FPSTACK_2,
        REGISTER_X86_FPSTACK_3,
        REGISTER_X86_FPSTACK_4,
        REGISTER_X86_FPSTACK_5,
        REGISTER_X86_FPSTACK_6,
        REGISTER_X86_FPSTACK_7,
                
        REGISTER_AMD64_RIP = 0,
        REGISTER_AMD64_RSP,
        REGISTER_AMD64_RBP,
                
        REGISTER_AMD64_RAX,
        REGISTER_AMD64_RCX,
        REGISTER_AMD64_RDX,
        REGISTER_AMD64_RBX,
                
        REGISTER_AMD64_RSI,
        REGISTER_AMD64_RDI,
                
        REGISTER_AMD64_R8,
        REGISTER_AMD64_R9,
        REGISTER_AMD64_R10,
        REGISTER_AMD64_R11,
        REGISTER_AMD64_R12,
        REGISTER_AMD64_R13,
        REGISTER_AMD64_R14,
        REGISTER_AMD64_R15,
                
        REGISTER_AMD64_XMM0,
        REGISTER_AMD64_XMM1,
        REGISTER_AMD64_XMM2,
        REGISTER_AMD64_XMM3,
        REGISTER_AMD64_XMM4,
        REGISTER_AMD64_XMM5,
        REGISTER_AMD64_XMM6,
        REGISTER_AMD64_XMM7,
        REGISTER_AMD64_XMM8,
        REGISTER_AMD64_XMM9,
        REGISTER_AMD64_XMM10,
        REGISTER_AMD64_XMM11,
        REGISTER_AMD64_XMM12,
        REGISTER_AMD64_XMM13,
        REGISTER_AMD64_XMM14,
        REGISTER_AMD64_XMM15,
                
        REGISTER_IA64_BSP = REGISTER_FRAME_POINTER,
        REGISTER_IA64_R0  = REGISTER_IA64_BSP + 1,
        REGISTER_IA64_F0  = REGISTER_IA64_R0  + 128,
                
        } CorDebugRegister;
        
        
    HRESULT GetRegisters (
        [in] ULONG64       mask, 
        [in] ULONG32       regCount,
        [out, size_is(regCount), length_is(regCount)]
            CORDB_REGISTER regBuffer[]
    );
        
    HRESULT GetRegistersAvailable (
        [out] ULONG64  *pAvailable
    );

    HRESULT SetRegisters (
        [in] ULONG64   mask,
        [in] ULONG32   regCount,
        [in, size_is(regCount)] CORDB_REGISTER regBuffer[]
    );
        
    HRESULT SetThreadContext (
           [in] ULONG32 contextSize,
           [in, length_is(contextSize),
               size_is(contextSize)] BYTE context[]
    );
        
}

方法

方法	描述
ICorDebugRegisterSet::GetRegisters 方法	取得位元遮罩指定之每個暫存器 (位於目前正在執行程式碼的電腦上) 的值。
ICorDebugRegisterSet::GetRegistersAvailable 方法	取得位元遮罩，表示 ICorDebugRegisterSet 中目前可用的暫存器。
ICorDebugRegisterSet::GetThreadContext 方法	取得目前執行緒的內容。
ICorDebugRegisterSet::SetRegisters 方法	未實作於 .NET Framework 2.0 版中。
ICorDebugRegisterSet::SetThreadContext 方法	未實作於 .NET Framework 2.0 中。

備註

ICorDebugRegisterSet 介面只支援 32 位元暫存器。在需要其他暫存器的平台上 (例如 IA-64)，使用 ICorDebugRegisterSet2 介面。

需求

**平台：**請參閱 .NET Framework 系統需求。

**標頭：**CorDebug.idl

**程式庫：**CorGuids.lib

**.NET Framework 版本：**3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0、1.1、1.0

請參閱

參考

ICorDebugRegisterSet2

其他資源

偵錯介面