Méthode IDebugDataSpaces2 ::ReadVirtualUncached (dbgeng.h)

Article
02/23/2024

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

Syntaxe

HRESULT ReadVirtualUncached(
  [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 qui ont été lus. Si elle est définie sur NULL, ces informations ne sont pas retournées.

Valeur retournée

Code de retour	Description
S_OK	La méthode a réussi. Il est possible que BytesRead soit inférieur à BufferSize, mais qu’au moins un octet de données soit 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 se comporte de manière identique à ReadVirtual, sauf qu’elle évite d’utiliser le cache de mémoire virtuelle. Il est donc utile pour lire la mémoire virtuelle intrinsèquement volatile, telle que les zones d’appareil mappées en mémoire, sans contaminer ou invalider le cache.