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

其他资源

调试接口