Share via


ICorDebugRegisterSet2::GetRegistersAvailable Method

Gets an array of bytes that provides a bitmap of the available registers.

HRESULT GetRegistersAvailable (
    [in] ULONG32 numChunks,
    [out, size_is(numChunks)] BYTE availableRegChunks[]
);

Parameters

  • numChunks
    [in] The size of the availableRegChunks array.

  • availableRegChunks
    [out] An array of bytes, each bit of which corresponds to a register. If a register is available, the register's corresponding bit is set.

Remarks

The values of the CorDebugRegister enumeration specify the registers of different microprocessors. The upper five bits of each value are the index into the availableRegChunks array of bytes. The lower three bits of each value identify the bit position within the indexed byte. Given a CorDebugRegister value that specifies a particular register, the register's position in the mask is determined as follows:

  1. Extract the index needed to access the correct byte in the availableRegChunks array:

    CorDebugRegister value >> 3

  2. Extract the bit position within the indexed byte, where bit zero is the least significant bit:

    CorDebugRegister value & 7

Requirements

Platforms: Windows 2000, Windows XP, Windows Server 2003 family

Header: CorDebug.idl

Library: CorGuids.lib

.NET Framework Version: 2.0

See Also

Concepts

ICorDebugRegisterSet2 Interface

ICorDebugRegisterSet Interface