Fonction NtFreeVirtualMemory (ntifs.h)

Les versions de routine NtFreeVirtualMemory , les dégagements ou les deux versions et les dégagements, une région de pages dans l’espace d’adressage virtuel d’un processus spécifié.

Syntaxe

__kernel_entry NTSYSCALLAPI NTSTATUS NtFreeVirtualMemory(
  [in]      HANDLE  ProcessHandle,
  [in, out] PVOID   *BaseAddress,
  [in, out] PSIZE_T RegionSize,
  [in]      ULONG   FreeType
);

Paramètres

[in] ProcessHandle

Handle pour le processus dans lequel résident les pages à libérer. Utilisez la macro NtCurrentProcess , définie dans Ntddk.h, pour spécifier le processus actuel.

[in, out] BaseAddress

Pointeur vers une variable qui recevra l’adresse virtuelle de base de la région libérée des pages.

Si l’indicateur MEM_RELEASE est défini dans le paramètre FreeType , *BaseAddress doit être l’adresse de base retournée par NtAllocateVirtualMemory lorsque la région a été réservée.

[in, out] RegionSize

Pointeur vers une variable qui recevra la taille réelle, en octets, de la région libérée des pages. La routine arrondit la valeur initiale de cette variable jusqu’à la limite de taille de page hôte suivante et réécrit la valeur arrondie dans cette variable.

Si l’indicateur MEM_RELEASE est défini dans *FreeType, *RegionSize doit être égal à zéro. NtFreeVirtualMemory libère toute la région qui a été réservée dans l’appel d’allocation initial à NtAllocateVirtualMemory.

Si l’indicateur MEM_DECOMMIT est défini dans *FreeType, NtFreeVirtualMemory supprime toutes les pages mémoire qui contiennent un ou plusieurs octets dans la plage de *BaseAddress à (*BaseAddress + *RegionSize). Cela signifie, par exemple, que si une région de mémoire de deux octets chevauche une limite de page, les deux pages sont décompressée.

NtFreeVirtualMemory désengage toute la région réservée par NtAllocateVirtualMemory. Si les trois conditions suivantes sont remplies, la région entière entre dans l’état réservé :

• L’indicateur MEM_DECOMMIT est défini.
• *BaseAddress est l’adresse de base retournée par NtAllocateVirtualMemory lorsque la région a été réservée.
• *RegionSize est égal à zéro.

[in] FreeType

Masque de bits contenant des indicateurs qui décrivent le type d’opération gratuite effectuée par NtFreeVirtualMemory pour la région de pages spécifiée. Les valeurs possibles sont répertoriées dans le tableau suivant.

Valeur retournée

NtFreeVirtualMemory retourne STATUS_SUCCESS ou une erreur status code. Les codes status d’erreur possibles incluent les éléments suivants.

Remarques

Chaque page de l’espace d’adressage virtuel du processus se trouve dans l’un des trois états décrits dans le tableau suivant.

NtFreeVirtualMemory peut effectuer les opérations suivantes :

• Décommit une région de pages validées ou non validées. Après cette opération, les pages sont à l’état réservé.
• Libérer une région de pages réservées. Après cette opération, les pages sont à l’état libre.
• Désengagez et libérez une région de pages validées ou non validées. Après cette opération, les pages sont à l’état libre.

NtFreeVirtualMemory peut supprimer une plage de pages qui se trouvent dans des états différents, certains validés et d’autres non validés. Cela signifie que vous pouvez désengagement d’une plage de pages sans déterminer au préalable l’état d’engagement actuel de chaque page. Le désengagement d’une page libère son stockage physique, soit en mémoire, soit dans le fichier de pagination sur le disque.

Si une page est décommise, mais pas publiée, son état devient réservé. Vous pouvez ensuite appeler NtAllocateVirtualMemory pour le valider, ou NtFreeVirtualMemory pour le libérer. La tentative de lecture à partir d’une page réservée ou d’écriture dans une page réservée entraîne une exception de violation d’accès.

NtFreeVirtualMemory peut publier une plage de pages qui sont dans des états différents, certains réservés et d’autres engagés. Cela signifie que vous pouvez publier une plage de pages sans déterminer au préalable l’état d’engagement actuel de chaque page. Toute la plage de pages initialement réservées par NtAllocateVirtualMemory doit être publiée en même temps.

Si une page est publiée, son état devient gratuit et elle est disponible pour les opérations d’allocation suivantes. Une fois la mémoire libérée ou libérée, vous ne pouvez plus jamais faire référence à la mémoire. Toutes les informations qui ont pu se trouver dans cette mémoire sont disparues pour toujours. La tentative de lecture à partir d’une page gratuite ou d’écriture dans une page gratuite entraîne une exception de violation d’accès. Si vous avez besoin d’informations, ne désengagez pas ou ne libérez pas la mémoire qui contient ces informations.

Pour plus d’informations sur la prise en charge de la gestion de la mémoire pour les pilotes en mode noyau, consultez Gestion de la mémoire pour les pilotes Windows.

Pour les appels à partir de pilotes en mode noyau, les versions NtXxx et ZwXxx d’une routine Windows Native System Services peuvent se comporter différemment dans la façon dont elles gèrent et interprètent les paramètres d’entrée. Pour plus d’informations sur la relation entre les versions NtXxx et ZwXxx d’une routine, consultez Utilisation des versions Nt et Zw des routines des services système natifs.

Configuration requise

Voir aussi

NtAllocateVirtualMemory