ICorDebugRegisterSet2::GetRegisters-Methode
Ruft den Wert jedes Registers (für die Plattform, auf der derzeit Code ausgeführt wird) ab, der von der angegebenen Bitmaske angegeben wird.
Syntax
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 Bytearray, von dem 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 erhalten.
Bemerkungen
Die GetRegisters-Methode gibt ein Array von Werten aus den Registern zurück, die von der Maske angegeben werden. Das Array enthält keine Werte von Registern, deren Maskenbit nicht festgelegt ist. Daher muss die Größe des regBuffer-Arrays gleich der Anzahl der Einsen in der Maske sein. Wenn der Wert von regCount zu klein für die Anzahl der durch die Maske angegebenen Register ist, werden die Werte der Register mit den höheren Nummern von der Menge abgeschnitten. Wenn regCount zu groß ist, bleiben die nicht verwendeten regBuffer-Elemente unverändert.
Wenn die Maske ein nicht verfügbares Register angibt, wird ein unbestimmter Wert für dieses Register zurückgegeben.
Die ICorDebugRegisterSet2::GetRegisters-Methode ist für Plattformen erforderlich, die mehr als 64 Register haben. IA64 verfügt beispielsweise über 128 universelle Register und 128 Gleitkommaregister, sodass in der Bitmaske mehr als 64 Bits erforderlich sind.
Wenn Sie nicht mehr als 64 Register haben, wie es auf Plattformen wie x86 der Fall ist, übersetzt die GetRegisters-Methode einfach die Bytes im Bytearray mask in ein ULONG64 und ruft dann die ICorDebugRegisterSet::GetRegisters-Methode auf, die die Maske ULONG64 verwendet.
Anforderungen
Plattformen: Informationen finden Sie unter Systemanforderungen.
Header: CorDebug.idl, CorDebug.h
Bibliothek: CorGuids.lib
.NET Framework-Versionen: Seit 2.0 verfügbar.
