Fonction DiscardVirtualMemory (memoryapi.h)

Article
08/24/2023

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