ICorDebugRegisterSet2::GetRegisters-Methode

Artikel
09/02/2008

Aktualisiert: November 2007

Ruft den Wert jedes Registers ab (für die Plattform, auf der zurzeit Code ausgeführt wird), das durch die Bitmaske angegeben wird.

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

Parameter

maskCount
[in] Die Größe des mask-Arrays in Bytes.
mask
[in] Ein Array von Bytes, von denen jedes Bit einem Register entspricht. Wenn das Bit 1 ist, wird der Wert des entsprechenden Registers abgerufen.
regCount
[in] Die Anzahl der abzurufenden Registerwerte.
regBuffer
[out] Ein Array von CORDB_REGISTER-Objekten, die jeweils den Wert eines Registers empfangen.

Hinweise

Die GetRegisters-Methode gibt ein Array von Werten von den Registern zurück, die von der Maske angegeben werden. Das Array enthält keine Werte von Registern, deren Maskenbit nicht festgelegt ist. Die Größe des regBuffer-Arrays muss daher mit der Anzahl von Einsen in der Maske übereinstimmen. Wenn der regCount-Wert für die von der Maske angegebene Anzahl von Registern zu klein ist, werden die Werte der Register mit höheren Nummern gekürzt. Wenn regCount zu groß ist, bleiben die nicht verwendeten regBuffer-Elemente unverändert.

Wenn die Maske angibt, dass ein Register nicht verfügbar ist, wird für dieses Register ein unbestimmter Wert zurückgegeben.

Die ICorDebugRegisterSet2::GetRegisters-Methode ist für Plattformen erforderlich, die über mehr als 64 Register verfügen. Für IA64 werden z. B. mehr als 64 Bit in der Bitmaske benötigt, da 128 Allzweckregister und 128 Gleitkommaregister verfügbar sind.

Wenn nicht mehr als 64 Register verfügbar sind, wie z. B. auf x86-Plattformen, übersetzt die GetRegisters-Methode die Bytes im mask-Bytearray einfach in ein ULONG64 und ruft anschließend die ICorDebugRegisterSet::GetRegisters-Methode auf, die die ULONG64-Maske verwendet.