Partager via


Fonction DiscardVirtualMemory (memoryapi.h)

Ignore le contenu de la mémoire d’une plage de pages mémoire, sans désengagement de la mémoire. Le contenu de la mémoire ignorée n’est pas défini et doit être réécrit par l’application.

Syntaxe

DWORD DiscardVirtualMemory(
  [in] PVOID  VirtualAddress,
  [in] SIZE_T Size
);

Paramètres

[in] VirtualAddress

Adresse de départ alignée sur la page de la mémoire à ignorer.

[in] Size

Taille, en octets, de la région de mémoire à ignorer. La taille doit être un multiple entier de la taille de la page système.

Valeur retournée

ERROR_SUCCESS en cas de réussite ; un code d’erreur système dans le cas contraire.

Notes

Si DiscardVirtualMemory échoue, le contenu de la région n’est pas modifié.

Utilisez cette fonction pour ignorer le contenu de la mémoire qui n’est plus nécessaire, tout en conservant la région de mémoire elle-même validée. L’abandon de la mémoire peut redonner de la RAM physique au système. Lorsque la région de mémoire est à nouveau accessible par l’application, la RAM de stockage est restaurée et le contenu de la mémoire n’est pas défini.

Important Les appels à DiscardVirtualMemory échouent si la protection de la mémoire n’est pas PAGE_READWRITE.
 

Spécifications

   
Client minimal pris en charge Mise à jour Windows 8.1 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2012 R2 Update [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête memoryapi.h (inclure Windows.h, Memoryapi.h)
Bibliothèque onecore.lib
DLL Kernel32.dll

Voir aussi

Fonctions de gestion de la mémoire

OfferVirtualMemory

ReclaimVirtualMemory

Fonctions de mémoire virtuelle

VirtualAlloc

VirtualFree

VirtualLock

VirtualQuery