Fonction ExFreeToNPagedLookasideList (wdm.h)
La routine ExFreeToNPagedLookasideList renvoie une entrée non paginé à la liste de lookaside donnée ou au pool non paginé.
Syntaxe
void ExFreeToNPagedLookasideList(
[in, out] PNPAGED_LOOKASIDE_LIST Lookaside,
[in] PVOID Entry
);
Paramètres
[in, out] Lookaside
Pointeur vers la structure NPAGED_LOOKASIDE_LIST de la liste de lookaside, que l’appelant a déjà initialisée avec ExInitializeNPagedLookasideList.
[in] Entry
Pointeur vers l’entrée à libérer. L’appelant a obtenu ce pointeur à partir d’un appel précédent à ExAllocateFromNPagedLookasideList.
Valeur de retour
None
Notes
Attention
À compter de Windows 11, version 22H2, cette fonction est passée de inline à exportée. Par conséquent, si vous générez votre pilote ciblant la dernière version de Windows, il ne pourra pas se charger dans les versions antérieures du système d’exploitation. Pour modifier la version du système d’exploitation cible dans Visual Studio, sélectionnez Propriétés de configuration-Paramètres> du pilote-Général>.
ExFreeToNPagedLookasideList est la réciproque de ExAllocateFromNPagedLookasideList. Il libère une entrée allouée à l’appelant dans la liste de lookaside de l’appelant ou dans le pool non paginé lorsque cette entrée n’est plus utilisée.
La même entrée peut être réaffectée ou une autre entrée allouée ultérieurement avec un appel suivant à ExAllocateFromNPagedLookasideList. L’utilisateur de la liste de lookaside peut allouer et libérer dynamiquement ces entrées en fonction des besoins jusqu’à ce qu’il appelle ExDeleteNPagedLookasideList, qui libère toutes les entrées en suspens dans la liste avant qu’il efface l’état système de la liste de lookaside donnée et retourne le contrôle.
Si la liste de lookaside spécifiée n’a pas encore atteint le nombre maximal d’entrées déterminé par le système, ExFreeToNPagedLookasideList insère l’entrée donnée au début de la liste. Sinon, la mémoire tampon à l’entrée est libérée dans le pool sans page à l’aide de la routine Free fournie par l’appelant, le cas échéant, qui a été configurée lors de l’initialisation de la liste de recherche ou d’ExFreePool.
Pour plus d’informations, consultez Utilisation de lookaside Listes.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible à partir de Windows 2000. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |
| Règles de conformité DDI | SpIrql(storport) |
Voir aussi
ExAllocateFromNPagedLookasideList