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

Article
02/26/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 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 au moins partiellement réussi. 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 façon 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, telle que les zones d’appareil mappées en mémoire, sans contaminer ou invalider le cache.