ExFreeToPagedLookasideList, fonction (wdm.h)
La routine ExFreeToPagedLookasideList retourne une entrée paginable à la liste lookaside donnée ou au pool paginé.
Syntaxe
void ExFreeToPagedLookasideList(
[in, out] PPAGED_LOOKASIDE_LIST Lookaside,
[in] PVOID Entry
);
Paramètres
[in, out] Lookaside
Pointeur vers la structure PAGED_LOOKASIDE_LIST de la liste lookaside, que l’appelant a déjà initialisée avec ExInitializePagedLookasideList, que l’appelant a déjà initialisé avec ExInitializePagedLookasideList.
[in] Entry
Pointeur vers l’entrée à libérer. L’appelant a obtenu ce pointeur à partir d’un appel précédent vers ExAllocateFromPagedLookasideList.
Valeur de retour
Aucun
Remarques
Prudence
À compter de Windows 11, version 22H2, cette fonction passe de l’inline à l’exportation. Par conséquent, si vous générez votre pilote ciblant la dernière version de Windows, il ne sera pas chargé dans les versions antérieures du système d’exploitation. Pour modifier la version cible du système d’exploitation dans Visual Studio, sélectionnez Propriétés de configuration->Paramètres du pilote ->Général.
ExFreeToPagedLookasideList est la réciproque d'ExAllocateFromPagedLookasideList. Il libère une entrée allouée par l’appelant à nouveau à la liste lookaside de l’appelant ou au pool 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 peut être allouée ultérieurement avec un appel ultérieur à ExAllocateFromPagedLookasideList. L’utilisateur d’une liste lookaside peut allouer et libérer de telles entrées dynamiquement, si nécessaire, jusqu’à ce qu’elle appelle ExDeletePagedLookasideList. ExDeletePagedLookasideList libère toutes les entrées en attente dans la liste avant d’effacer l’état système de la liste lookaside donnée et retourne le contrôle.
Si la liste lookaside spécifiée n’a pas encore atteint le nombre maximal déterminé par le système d’entrées, ExFreeToPagedLookasideList insère l’entrée donnée en face de la liste. Sinon, la mémoire tampon à entrée est renvoyée au pool paginé à l’aide de la routine Free fournie par l’appelant, le cas échéant, qui a été configurée lorsque la liste de lookaside a été initialisée ou ExFreePool.
Sur Windows 2000, les pilotes doivent utiliser le commutateur -D_WIN2K_COMPAT_SLIST_USAGE pour lier le code qui utilise ExFreeToPagedLookasideList.
Pour plus d’informations, consultez Using Lookaside Lists.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows 2000. |
| plateforme cible | Universel |
| d’en-tête | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |
Voir aussi
ExAllocateFromPagedLookasideList