Metodo ICorDebugRegisterSet2::GetRegisters

Aggiornamento: novembre 2007

Ottiene il valore di ogni registro, per la piattaforma sulla quale è al momento in esecuzione il codice, specificato dalla maschera di bit.

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

Parametri

• maskCount
  [in] Dimensione, in byte, della matrice mask.

• mask
  [in] Una matrice di byte, ogni bit della quale corrisponde a un registro. Se il bit vale 1, il valore del registro corrispondente verrà recuperato.

• regCount
  [in] Numero di valori di registro da recuperare.

• regBuffer
  [out] Matrice di oggetti CORDB_REGISTER, ognuno dei quali riceve il valore di un registro.

Note

Il metodo GetRegisters restituisce una matrice di valori dai registri specificati dalla maschera. La matrice non contiene valori di registri il cui bit non è impostato nella maschera. Di conseguenza, la dimensione della matrice regBuffer deve essere uguale al numero di 1 nella maschera. Se il valore di regCount è troppo piccolo per il numero di registri indicato dalla maschera, i valori dei registri con numero più alto verranno troncati nell’insieme. Se il valore di regCount è troppo elevato, gli elementi di regBuffer inutilizzati non verranno modificati.

Se nella maschera viene indicato un registro non disponibile, per tale registro verrà restituito un valore indeterminato.

Il metodo ICorDebugRegisterSet2::GetRegisters è necessario per le piattaforme che hanno più di 64 registri. Ad esempio, IA64 ha 128 registri di uso generale e 128 registri a virgola mobile; di conseguenza, sono necessari più di 64 bit nella maschera di bit.

Se non si hanno più di 64 registri, come è il caso delle piattaforme come x86, il metodo GetRegisters converte semplicemente i byte nella matrice di byte mask in un valore ULONG64 e quindi chiama il metodo ICorDebugRegisterSet::GetRegisters che utilizza la maschera ULONG64.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: CorDebug.idl

Libreria: CorGuids.lib

Versioni di .NET Framework: 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Vedere anche

Riferimenti

ICorDebugRegisterSet2

ICorDebugRegisterSet