Fonction ReclaimVirtualMemory (memoryapi.h)

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

Voir aussi

Fonctions de gestion de la mémoire

OfferVirtualMemory

Fonctions de mémoire virtuelle

VirtualAlloc

VirtualFree

VirtualLock

VirtualQuery