Freigeben über

ICorDebugRegisterSet2::GetRegisters-Methode

Ruft den Wert der einzelnen Register (für die Plattform, auf der code derzeit ausgeführt wird) ab, die durch die angegebene 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[]
);

Die Parameter

maskCount [in] Die Größe des mask Arrays in Byte.

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, von denen jeder den Wert eines Registers empfängt.

Bemerkungen

Die GetRegisters Methode gibt ein Array von Werten aus den Registern zurück, die durch die Maske angegeben werden. Das Array enthält keine Werte von Registern, deren Maskenbit nicht festgelegt ist. Daher muss die Größe des regBuffer Arrays der Anzahl von 1 in der Maske entsprechen. Wenn der Wert für regCount die Anzahl von Registern, die durch die Maske angegeben sind, zu klein ist, werden die Werte der höheren nummerierten Register aus dem Satz abgeschnitten. Wenn regCount sie zu groß ist, werden die nicht verwendeten regBuffer Elemente unverändert.

Wenn ein nicht verfügbares Register durch die Maske angegeben wird, wird für dieses Register ein unbestimmter Wert zurückgegeben.

Die ICorDebugRegisterSet2::GetRegisters Methode ist für Plattformen mit mehr als 64 Registern erforderlich. Beispielsweise verfügt IA64 über 128 allgemeine Register und 128 Gleitkommaregister, daher benötigen Sie mehr als 64 Bit in der Bitmaske.

Wenn Sie nicht mehr als 64 Register besitzen, wie dies auf Plattformen wie x86 der Fall ist, übersetzt die GetRegisters Methode einfach die Bytes im mask Bytearray in ein ULONG64 und ruft dann die ICorDebugRegisterSet::GetRegisters-Methode auf, die die ULONG64 Maske verwendet.

Anforderungen

Plattformen: Siehe .NET unterstützte Betriebssysteme.

Kopfball: CorDebug.idl, CorDebug.h

Bibliothek: CorGuids.lib

.NET-Versionen: Verfügbar seit .NET Framework 2.0

Siehe auch

  • Last updated on