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

Article
02/23/2024

La méthode GetValues obtient la valeur de plusieurs registres de la cible.

Syntaxe

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

Paramètres

[in] Count

Spécifie le nombre de registres dont les valeurs sont demandées.

[in, optional] Indices

Spécifie un tableau qui contient les index des registres à partir desquels obtenir 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 lus consécutivement à partir de cet index. Sinon, il est ignoré.

[out] Values

Reçoit les valeurs des registres. Le nombre d’éléments que ce tableau contient 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 l’un des registres n’est pas accessible.
E_INVALIDARG	La valeur de l’index de l’un des registres est supérieure au nombre de registres sur l’ordinateur cible. Des résultats partiels ont peut-être été obtenus ; les registres qui n’ont pas pu être lus auront le type DEBUG_VALUE_INVALID.

Remarques

GetValues obtient la valeur de plusieurs registres de la cible.

Si la valeur de retour n’est pas S_OK, certains des registres ont peut-être encore été lus. Si la cible n’était pas accessible, le type de retour est E_UNEXPECTED et Les valeurs sont inchangées ; sinon, les valeurs contiennent des résultats partiels et les registres qui n’ont pas pu être lus ont le type DEBUG_VALUE_INVALID. L’ambiguïté dans le cas de la valeur de retour E_UNEXPECTED peut être évitée en définissant la mémoire de Valeurs sur zéro avant d’appeler cette méthode.

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

La méthode GetValues2 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