ExFreeToNPagedLookasideList-Funktion (wdm.h)

Die ExFreeToNPagedLookasideList-Routine gibt einen nicht ausseitigen Eintrag in die angegebene Lookaside-Liste oder an einen nicht ausseitigen Pool zurück.

Syntax

void ExFreeToNPagedLookasideList(
  [in, out] PNPAGED_LOOKASIDE_LIST Lookaside,
  [in]      PVOID                  Entry
);

Parameter

[in, out] Lookaside

Ein Zeiger auf die NPAGED_LOOKASIDE_LIST-Struktur für die Lookaside-Liste, die der Aufrufer bereits mit ExInitializeNPagedLookasideList initialisiert hat.

[in] Entry

Ein Zeiger auf den frei zu gebenden Eintrag. Der Aufrufer hat diesen Zeiger aus einem vorherigen Aufruf von ExAllocateFromNPagedLookasideList abgerufen.

Rückgabewert

Keine

Bemerkungen

Achtung

Ab Windows 11 Version 22H2 wurde diese Funktion von inline in exportiert geändert. Wenn Sie Ihren Treiber für die neueste Version von Windows erstellen, kann er daher in älteren Betriebssystemversionen nicht geladen werden. Um die Zielbetriebssystemversion in Visual Studio zu ändern, wählen Sie Konfigurationseigenschaften-Treibereinstellungen-Allgemein>> aus.

ExFreeToNPagedLookasideList ist der Kehrwert von ExAllocateFromNPagedLookasideList. Es gibt einen vom Aufrufer zugewiesenen Eintrag wieder an die Lookaside-Liste des Aufrufers oder an einen nicht ausseitigen Pool frei, wenn dieser Eintrag nicht mehr verwendet wird.

Derselbe Eintrag kann neu zugeordnet oder ein anderer Eintrag später mit einem nachfolgenden Aufruf von ExAllocateFromNPagedLookasideList zugeordnet werden. Der Benutzer der Lookaside-Liste kann solche Einträge dynamisch nach Bedarf zuordnen und freigeben, bis er ExDeleteNPagedLookasideList aufruft, wodurch alle ausstehenden Einträge in der Liste freigegeben werden, bevor der Systemzustand für die angegebene Lookaside-Liste gelöscht und die Steuerung zurückgegeben wird.

Wenn die angegebene Lookaside-Liste noch nicht die vom System festgelegte maximale Anzahl von Einträgen erreicht hat, fügt ExFreeToNPagedLookasideList den angegebenen Eintrag am Anfang der Liste ein. Andernfalls wird der Puffer bei Entry mit der vom Aufrufer bereitgestellten Free-Routine freigegeben, sofern vorhanden, die beim Initialisieren der Lookaside-Liste oder ExFreePool eingerichtet wurde.

Weitere Informationen finden Sie unter Verwenden von Lookaside Listen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 2000.
Zielplattform	Desktop
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL
DDI-Complianceregeln	SpIrql(storport)

Weitere Informationen

ExAllocateFromNPagedLookasideList

ExDeleteNPagedLookasideList

ExInitializeNPagedLookasideList

NPAGED_LOOKASIDE_LIST