Méthode IDebugDataSpaces4 ::WriteVirtualUncached (dbgeng.h)

Article
02/23/2024

La méthode WriteVirtualUncached écrit des données dans l’espace d’adressage virtuel de la cible.

Syntaxe

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

Paramètres

[in] Offset

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

[in] Buffer

Spécifie la mémoire tampon à partir de laquelle écrire la mémoire.

[in] BufferSize

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

[out, optional] BytesWritten

Reçoit le nombre d’octets qui ont été réellement écrits. Si elle est définie sur NULL, ces informations ne sont pas retournées.

Valeur retournée

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

Code de retour	Description
S_OK	La méthode a réussi au moins partiellement. BytesWritten indique le nombre d’octets correctement écrits, qui peut être inférieur à BufferSize.

Remarques

Cette méthode écrit la mémoire tampon dans la mémoire dans l’espace d’adressage virtuel de la cible.

Cette méthode se comporte de manière identique à WriteVirtual, 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.