IDebugDataSpaces2 ::ReadVirtual, méthode (dbgeng.h)

Article
02/06/2025

La méthode ReadVirtual lit la mémoire à partir de l’espace d’adressage virtuel de la cible.

Syntaxe

HRESULT ReadVirtual(
  [in]            ULONG64 Offset,
  [out]           PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  BytesRead
);

Paramètres

[in] Offset

Spécifie l’emplacement dans l’espace d’adressage virtuel de la cible à lire.

[out] Buffer

Spécifie la mémoire tampon dans laquelle lire la mémoire.

[in] BufferSize

Spécifie la taille en octets de la mémoire tampon. Il s’agit également du nombre d’octets demandés.

[out, optional] BytesRead

Reçoit le nombre d’octets lus. S’il est défini sur NULL, ces informations ne sont pas retournées.

Valeur de retour

Retourner le code	Description
S_OK	La méthode a réussi. Il est possible que BytesRead soit inférieur à BufferSize, mais au moins un octet de données a été retourné.

Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez valeurs de retour.

Remarques

Cette méthode remplit la mémoire tampon avec le contenu de la mémoire dans l’espace d’adressage virtuel de la cible.

Cette méthode peut référencer un cache de données mémoire lors de la récupération des données. Si les données sont volatiles, telles que l’état matériel mappé en mémoire, utilisez ReadVirtualUncached à la place.

Lors de la lecture de la mémoire qui contient des pointeurs, ces pointeurs concernent l’espace d’adressage virtuel de la cible et non pour le moteur. Par exemple, si une structure de données contenait une chaîne, un deuxième appel à cette méthode peut être nécessaire pour lire le contenu de la chaîne.