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