ICorDebugRegisterSet::GetRegisters-Methode

Aktualisiert: November 2007

Ruft den Wert jedes Registers ab (auf dem Computer, auf dem derzeit Code ausgeführt wird), das durch die Bitmaske angegeben wird.

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

Parameter

mask
[in] Eine Bitmaske, die angibt, welche Registerwerte abgerufen werden sollen. Jedes Bit entspricht einem Register. Wenn ein Bit auf 1 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, die jeweils einen Wert eines Registers empfangen.

Hinweise

Die Größe des Arrays sollte der Anzahl der auf 1 gesetzten Bits in der Bitmaske entsprechen. Der regCount-Parameter gibt die Anzahl der Elemente im Puffer an, der die Registerwerte empfängt. Wenn der regCount-Wert für die von der Maske angegebene Anzahl von Registern zu klein ist, werden die Register mit höheren Nummern aus der Gruppe abgeschnitten. Wenn der regCount-Wert zu groß ist, bleiben die nicht verwendeten regBuffer-Elemente unverändert.

Wenn die Bitmaske angibt, dass ein Register nicht verfügbar ist, gibt GetRegisters einen unbestimmten Wert für dieses Register zurück.