Fonction ExFreeToLookasideListEx (wdm.h)

  • Article

La routine ExFreeToLookasideListEx insère une entrée dans une liste de recherche ou, si la liste est complète, libère le stockage alloué pour l’entrée.

Syntaxe

void ExFreeToLookasideListEx(
  [in, out] PLOOKASIDE_LIST_EX Lookaside,
  [in]      PVOID              Entry
);

Paramètres

[in, out] Lookaside

Pointeur vers une structure de LOOKASIDE_LIST_EX qui décrit une liste de lookaside. Cette structure a été initialisée par la routine ExInitializeLookasideListEx .

[in] Entry

Pointeur vers l’entrée lookaside-list en cours de libération.

Valeur de retour

None

Notes

Attention

À partir de Windows 11, version 22H2, cette fonction est passée d’inline à exportée. Par conséquent, si vous générez votre pilote ciblant la dernière version de Windows, il ne parvient pas à se charger dans les anciennes versions 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>.

Cette routine libère une entrée lookaside-list qui a été allouée par un appel précédent à la routine ExAllocateFromLookasideListEx . ExFreeToLookasideListEx insère l’entrée dans la liste de recherche spécifiée, si l’espace pour l’entrée est disponible dans la liste. Si la liste est complète (c’est-à-dire qu’elle contient déjà le nombre maximal d’entrées, tel que déterminé par le système d’exploitation), ExFreeToLookasideListEx appelle la routine LookasideListFreeEx pour libérer le stockage de l’entrée spécifiée, si le pilote a fourni une telle routine. Sinon, une routine de désallocation par défaut est utilisée pour libérer l’entrée.

Pour plus d’informations sur les listes de lookaside, consultez Utilisation de lookaside Listes.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows Vista et les versions plus récentes de Windows.
Plateforme cible Desktop (Expérience utilisateur)
En-tête wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL

Voir aussi

ExAllocateFromLookasideListEx

ExInitializeLookasideListEx

LOOKASIDE_LIST_EX