Fonction ExFreeToPagedLookasideList (wdm.h)

  • Article

La routine ExFreeToPagedLookasideList renvoie une entrée paginable à la liste de lookaside ou au pool paginé donné.

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 de 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 à ExAllocateFromPagedLookasideList.

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>.

ExFreeToPagedLookasideList est la réciproque de ExAllocateFromPagedLookasideList. Il libère une entrée allouée à l’appelant dans la liste de recherche de l’appelant ou dans le 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 de lookaside peut allouer et libérer ces entrées dynamiquement, si nécessaire, jusqu’à ce qu’il appelle ExDeletePagedLookasideList. ExDeletePagedLookasideList libère toutes les entrées en suspens dans la liste avant d’effacer l’état système de la liste de lookaside donnée et de retourner 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, ExFreeToPagedLookasideList insère l’entrée donnée au début de la liste. Sinon, la mémoire tampon à l’entrée est remise dans le pool paginé à l’aide de la routine Gratuite 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.

Sur Windows 2000, les pilotes doivent utiliser le commutateur -D_WIN2K_COMPAT_SLIST_USAGE pour lier correctement le code qui utilise ExFreeToPagedLookasideList.

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 Universal
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

ExDeletePagedLookasideList

ExInitializePagedLookasideList

PAGED_LOOKASIDE_LIST