Edit

Share via

ICorDebugRegisterSet2::GetRegistersAvailable Method

  • Article

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

Syntax

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: See System Requirements.

Header: CorDebug.idl, CorDebug.h

Library: CorGuids.lib

.NET Framework Versions: Available since 2.0

See also