IDebugDataSpaces4::ReadVirtualUncached, méthode (dbgeng.h)

Article
08/13/2022
2 minutes de lecture

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. S’il est défini sur NULL, ces informations ne sont pas retournées.

Valeur de retour

Code de retour	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 est 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 de lire une mémoire virtuelle intrinsèquement volatile, telle que des zones d’appareil mappées en mémoire, sans contaminer ou invalider le cache.

Configuration requise


Plateforme cible	Desktop (Expérience utilisateur)
En-tête	dbgeng.h (include Dbgeng.h)

Voir aussi