Freigeben über


ICorDebugRegisterSet::GetRegisters-Methode

Ruft den Wert der einzelnen Register (auf dem Computer, auf dem derzeit Code ausgeführt wird) ab, der durch die Bitmaske angegeben wird.

Syntax

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

Die Parameter

mask [in] Eine Bitmaske, die angibt, welche Registerwerte abgerufen werden sollen. Jedes Bit entspricht einem Register. Wenn ein Bit auf eins festgelegt ist, wird der Wert des Registers abgerufen; andernfalls wird der Wert des Registers nicht abgerufen.

regCount [in] Die Anzahl der abzurufenden Registerwerte.

regBuffer [out] Ein Array von CORDB_REGISTER Objekten, von denen jeder einen Wert eines Registers erhält.

Bemerkungen

Die Größe des Arrays sollte der Anzahl der Bits entsprechen, die in der Bitmaske auf eins festgelegt sind. Der regCount Parameter gibt die Anzahl der Elemente im Puffer an, die die Registerwerte erhalten. Wenn der regCount Wert für die Anzahl der durch die Maske angegebenen Register zu klein ist, werden die höheren nummerierten Register aus dem Satz abgeschnitten. Wenn der regCount Wert zu groß ist, werden die nicht verwendeten regBuffer Elemente unverändert.

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

Anforderungen

Plattformen: Siehe .NET unterstützte Betriebssysteme.

Kopfball: CorDebug.idl, CorDebug.h

Bibliothek: CorGuids.lib

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

Siehe auch