Fonction ExFreeToNPagedLookasideList (wdm.h)

  • Article

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

ExDeleteNPagedLookasideList

ExInitializeNPagedLookasideList

NPAGED_LOOKASIDE_LIST