Partager via


IDebugHostMemory2 ::ReadBytes, méthode (dbgmodel.h)

Lit un certain nombre d’octets à partir de l’espace d’adressage de la cible, tel que défini par le contexte et l’emplacementpassés. Le nombre d’octets lus est retourné en « octetsRead » 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 les 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 sont écrits dans cette mémoire tampon.

bufferSize

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

bytesRead

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

Valeur de retour

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

Exigences

Exigence Valeur
d’en-tête dbgmodel.h

Voir aussi

interface IDebugHostMemory2