Share via

ICorDebugRegisterSet::GetRegisters, méthode

  • Article

Obtient la valeur de chaque registre (sur l’ordinateur exécutant actuellement le code) spécifié par le masque de bits.

Syntaxe

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

Paramètres

mask
[in] Masque de bits qui spécifie les valeurs de registre à récupérer. Chaque bit correspond à un registre. Si un bit est défini sur un, la valeur du registre est récupérée ; sinon, elle n’est pas récupérée.

regCount
[in] Nombre de valeurs de registre à récupérer.

regBuffer
[out] Tableau d’objets CORDB_REGISTER, chacun recevant une valeur d’un registre.

Notes

La taille du tableau doit être égale au nombre de bits défini sur un dans le masque de bits. Le paramètre regCount spécifie le nombre d’éléments dans la mémoire tampon qui recevront les valeurs de registre. Si la valeur regCount est trop petite pour le nombre de registres indiqué par le masque, les registres avec un numéro plus élevé sont tronqués de l’ensemble. Si la valeur regCount est trop grande, les éléments regBuffer inutilisés ne sont pas modifiés.

Si le masque de bits spécifie un registre qui n’est pas disponible, GetRegisters retourne une valeur indéterminée pour ce registre.

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : CorDebug.idl, CorDebug.h

Bibliothèque : CorGuids.lib

Versions de .NET Framework : Disponible à partir de la version 1.0

Voir aussi