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

Article
02/06/2025

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 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 octetsRead soit inférieur à BufferSize, mais qu’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 façon identique à ReadVirtual, sauf qu’elle évite d’utiliser le cache de mémoire virtuelle. Il est donc utile de 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.