Fonction ReclaimVirtualMemory (memoryapi.h)

Article
03/01/2024

Récupère une plage de pages mémoire qui ont été proposées au système avec OfferVirtualMemory.

Si la mémoire proposée a été ignorée, le contenu de la région de mémoire n’est pas défini et doit être réécrit par l’application. Si la mémoire proposée n’a pas été ignorée, elle est récupérée intacte.

Syntaxe

DWORD ReclaimVirtualMemory(
  [in] void const *VirtualAddress,
  [in] SIZE_T     Size
);

Paramètres

[in] VirtualAddress

Adresse de départ alignée sur la page de la mémoire à récupérer.

[in] Size

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

Valeur retournée

Retourne ERROR_SUCCESS en cas de réussite et si la mémoire a été récupérée intacte.

Retourne ERROR_BUSY si elle réussit, mais que la mémoire a été ignorée et doit être réécrite par l’application. Dans ce cas, le contenu de la région de mémoire n’est pas défini.

Retourne un code d’erreur système dans le cas contraire.

Remarques

Les pages de mémoire récupérées peuvent être utilisées par l’application et sont écrites dans le fichier de pagination système si la pagination se produit.

Si la fonction retourne ERROR_SUCCESS, les données dans les pages récupérées sont valides. Si la fonction retourne ERROR_BUSY, les données des pages récupérées ont été ignorées par le système et ne sont plus valides. Pour cette raison, la mémoire ne doit être offerte au système que si l’application n’a pas besoin ou ne peut pas régénérer les données.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Mise à jour Windows 8.1 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	mise à jour Windows Server 2012 R2 [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