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

Article
02/23/2024

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

Syntaxe

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

Paramètres

[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 Index 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

Spécifie le 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.
E_UNEXPECTED	La cible n’est pas accessible, ou un ou plusieurs des registres n’ont pas pu être consultés.
E_INVALIDARG	La valeur de l’index d’un ou plusieurs registres est supérieure au nombre de registres sur l’ordinateur cible.

Remarques

Le moteur fait de son mieux pour contraindre les valeurs dans Valeurs dans le type des registres ; cette contrainte 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 registres ont peut-être été définis.

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

Pour définir la valeur d’un seul registre, utilisez plutôt la méthode SetValue .

La méthode SetValues2 effectue la même tâche que cette méthode, mais permet également de spécifier la source du 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