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

Article
02/06/2025

La méthode SetValues2 définit la valeur de plusieurs registres 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 d’inscription à interroger.

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

Valeur	Inscrire la source
DEBUG_REGSRC_DEBUGGEE	Récupérez les informations d’inscription à partir de la cible.
DEBUG_REGSRC_EXPLICIT	Récupérez les informations d’inscription à partir du contexte de registre explicite actuel.
DEBUG_REGSRC_FRAME	Récupérez les informations d’inscription à partir du contexte de registre de l’étendue actuelle. Remarque Déroulement de la pile ne garantit pas la mise à jour précise du contexte de registre. Par conséquent, le contexte de registre du cadre d’étendue peut ne pas être précis 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 de ce tableau est Count. Si index est NULL, démarrer est utilisé à la place.

[in] Start

Si index est NULL, les registres sont définis consécutivement à partir de cet index. Sinon, elle est ignorée.

[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 de retour

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

Retourner le code	Description
S_OK	La méthode a réussi.

Remarques

Le moteur fait de son mieux pour convertir 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 aux entiers sont également effectuées si nécessaire.

Si la valeur de retour n’est pas S_OK, certains 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 d’inscription.

Pour obtenir une vue d’ensemble de l’interface IDebugRegisters et d’autres méthodes liées à l’inscription, consultez Registers.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	dbgeng.h (include DbgEng.h)

Voir aussi

IDebugRegisters2

SetValue

SetValues

Partager via