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

Article
02/26/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, comme les zones d’appareil mappées à la mémoire, sans contaminer ou invalider le cache.