Partager via

ICorDebugRegisterSet2 ::GetRegisters, méthode

Obtient la valeur de chaque registre (pour la plateforme sur laquelle le code est en cours d’exécution) spécifié par le masque de bits donné.

Syntaxe

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

Paramètres

maskCount [in] Taille, en octets, du mask tableau.

mask [in] Tableau d’octets, dont chaque bit correspond à un registre. Si le bit est 1, la valeur du registre correspondant est récupérée.

regCount [in] Nombre de valeurs d’inscription à récupérer.

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

Remarques

La GetRegisters méthode retourne un tableau de valeurs des registres spécifiés par le masque. Le tableau ne contient pas de valeurs de registres dont le bit de masque n’est pas défini. Ainsi, la taille du regBuffer tableau doit être égale au nombre de 1 dans le masque. Si la valeur est regCount trop petite pour le nombre de registres indiqués par le masque, les valeurs des registres numérotés plus élevés sont tronquées à partir du jeu. S’il regCount est trop volumineux, les éléments inutilisés regBuffer ne sont pas modifiés.

Si un registre non disponible est indiqué par le masque, une valeur indéterminée est retournée pour ce registre.

La ICorDebugRegisterSet2::GetRegisters méthode est nécessaire pour les plateformes qui ont plus de 64 registres. Par exemple, IA64 a 128 registres à usage général et 128 registres à virgule flottante. Vous avez donc besoin de plus de 64 bits dans le masque de bits.

Si vous n’avez pas plus de 64 registres, comme c’est le cas sur des plateformes telles que x86, la GetRegisters méthode traduit simplement les octets du mask tableau d’octets en un ULONG64 , puis appelle la méthode ICorDebugRegisterSet ::GetRegisters , qui prend le ULONG64 masque.

Spécifications

Plates-formes: Consultez les systèmes d’exploitation pris en charge par .NET.

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

Bibliothèque: CorGuids.lib

Versions de .NET : Disponible depuis .NET Framework 2.0

Voir aussi

  • Last updated on