ICorDebugRegisterSet::GetRegisters 方法

获取当前正在执行代码的计算机上由位掩码指定的每个寄存器的值。

HRESULT GetRegisters (
    [in] ULONG64       mask, 
    [in] ULONG32       regCount,
    [out, size_is(regCount), length_is(regCount)]
        CORDB_REGISTER regBuffer[]
);

参数

mask
[in] 指定要检索的寄存器值的位掩码。每个位与一个寄存器相对应。如果位设置为 1，则检索寄存器的值；否则，将不检索寄存器的值。
regCount
[in] 要检索的寄存器值的数目。
regBuffer
[out] 一个由 CORDB_REGISTER 对象构成的数组，其中的每个对象都会接收一个寄存器的值。

备注

数组的大小应和位掩码中设置为 1 的位的数目相等。 regCount 参数指定将接收寄存器值的缓冲区中的元素数。如果 regCount 的值对于掩码指示的寄存器数而言太小，则将从集合中截断编号较高的寄存器。如果 regCount 的值太大，则未使用的 regBuffer 元素将保持不变。

如果位掩码指定的寄存器不可用，则 GetRegisters 将为该寄存器返回一个不确定值。

要求

**平台：**请参见 .NET Framework 系统要求。

头文件： CorDebug.idl、CorDebug.h

**库：**CorGuids.lib

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

请参见

参考

ICorDebugRegisterSet 接口

ICorDebugRegisterSet2 接口

Last updated on 2011-08-12