IDebugRegisters2 ::GetValues, méthode (dbgeng.h)

Article
02/06/2025

La méthode GetValues obtient la valeur de plusieurs registres 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 de ce tableau est Count. Si index est NULL, démarrer est utilisé à la place.

[in] Start

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

[out] Values

Reçoit les valeurs des 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.
E_UNEXPECTED	La cible n’est pas accessible, ou l’un des registres n’a pas pu être 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 peuvent avoir été obtenus ; ces 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 registres ont peut-être encore été lus. Si la cible n’a pas été accessible, le type de retour est E_UNEXPECTED et Valeurs est inchangé ; sinon, Valeurs contiendra des résultats partiels et les registres qui n’ont pas pu être lus auront DEBUG_VALUE_INVALID de type. 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 la méthode getValue à la place.

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

Voir aussi

GetValue

GetValues2

IDebugRegisters

IDebugRegisters2

Partager via