IDebugRegisters2 ::SetValues, méthode (dbgeng.h)
La méthode SetValues définit la valeur de plusieurs registres 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 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
Spécifie le tableau qui contient des 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 |
|---|---|
|
La méthode a réussi. |
|
La cible n’est pas accessible, ou un ou plusieurs des registres ne sont pas accessibles. |
|
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 forcer 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 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 contenant celui-ci est également modifié.
Pour définir la valeur d’un seul registre, utilisez la méthode SetValue à la place.
La méthode SetValues2 effectue la même tâche que cette méthode, mais permet également à la source d’inscription d’être spécifiée.
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) |