Méthode IDebugRegisters2 ::SetValues2 (dbgeng.h)

Article
08/07/2023

La méthode SetValues2 définit la valeur de plusieurs registres de la cible.

Syntaxe

HRESULT SetValues2(
  [in]           ULONG        Source,
  [in]           ULONG        Count,
  [in, optional] PULONG       Indices,
  [in]           ULONG        Start,
  [in]           PDEBUG_VALUE Values
);

Paramètres

[in] Source

Spécifie la source de registre à interroger.

Les valeurs possibles sont répertoriées dans le tableau suivant.

Valeur	Inscrire la source
DEBUG_REGSRC_DEBUGGEE	Récupérez les informations du registre à partir de la cible.
DEBUG_REGSRC_EXPLICIT	Récupérez les informations de registre à partir du contexte de registre explicite actuel.
DEBUG_REGSRC_FRAME	Récupérez les informations de registre à partir du contexte d’inscription de l’étendue actuelle. Note Le déroulement de la pile ne garantit pas la mise à jour exacte du contexte d’enregistrement, de sorte que le contexte d’enregistrement de la trame d’étendue peut ne pas être exact dans tous les cas.

[in] Count

Spécifie le nombre de registres pour lesquels définir les valeurs.

[in, optional] Indices

Spécifie un tableau qui contient les index des registres pour lesquels définir les valeurs. Le nombre d’éléments dans ce tableau est Count. Si Indexs a la valeur NULL, Start est utilisé à la place.

[in] Start

Si Index a la valeur NULL, les registres sont définis consécutivement à partir de cet index. Sinon, il est ignoré.

[in] Values

Tableau qui contient les valeurs auxquelles définir les registres. Le nombre d’éléments que contient ce tableau est Count. Consultez DEBUG_VALUE pour obtenir une description de ce type de paramètre.

Valeur retournée

Cette liste ne contient pas toutes les erreurs qui peuvent se produire. Pour obtenir la liste des erreurs possibles, consultez Valeurs HRESULT.

Code de retour	Description
S_OK	La méthode a réussi.

Remarques

Le moteur fait de son mieux pour transformer les valeurs dans Valeurs dans le type des registres ; cette conversion est la même que celle effectuée par CoerceValue. Si la valeur est supérieure à ce que le registre peut contenir, les bits les moins significatifs sont supprimés. Les conversions à virgule flottante et entière sont également effectuées si nécessaire.

Si la valeur de retour n’est pas S_OK, certains des registres ont peut-être encore été définis.

Lorsqu’une sous-inscription est modifiée, le registre qui le contient est également modifié.

La méthode SetValues effectue la même tâche que cette méthode, mais utilise toujours la cible comme source de registre.

Pour obtenir une vue d’ensemble de l’interface IDebugRegisters et d’autres méthodes liées au registre, consultez Registres.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	dbgeng.h (inclure DbgEng.h)

Voir aussi

IDebugRegisters2

SetValue

SetValues

Partager via