Méthode IDebugHostMemory2 ::ReadBytes (dbgmodel.h)

Lit un nombre d’octets à partir de l’espace d’adressage de la cible tel que défini par le contexte et l’emplacement entrés. Le nombre d’octets lus est retourné dans « bytesRead » en cas de réussite.

Syntaxe

HRESULT ReadBytes(
  IDebugHostContext *context,
  Location          location,
  void              *buffer,
  ULONG64           bufferSize,
  ULONG64           *bytesRead
);

Paramètres

context

Contexte hôte dans lequel lire des octets. Cela représente, par exemple, l’espace d’adressage dans lequel l’emplacement existe.

location

Emplacement auquel lire des octets. Cet emplacement peut représenter une adresse virtuelle dans l’espace d’adressage défini par le contexte ou représenter quelque chose comme un registre dans un enregistrement de contexte pour un thread.

buffer

Les octets lus à partir de la cible de débogage seront écrits dans cette mémoire tampon.

bufferSize

Taille de la mémoire tampon et nombre d’octets à lire.

bytesRead

Le nombre d’octets effectivement lus à partir de la cible de débogage sera retourné ici. Si la méthode peut terminer une lecture partielle, S_FALSE sera retourné et la valeur en octetsRead peut être inférieure au nombre d’octets demandé. Si la méthode retourne S_OK, une lecture complète a été effectuée.

Valeur retournée

Cette méthode retourne HRESULT qui indique la réussite ou l’échec.

Configuration requise

Condition requise	Valeur
En-tête	dbgmodel.h

Voir aussi

Interface IDebugHostMemory2