ExFreeToNPagedLookasideList-Funktion (wdm.h)
Die ExFreeToNPagedLookasideList Routine gibt einen nicht seitenseitigen Eintrag in die angegebene Lookaside-Liste oder in einen nicht seitenfreien 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 ExInitializeNPagedLookasideListinitialisiert hat.
[in] Entry
Ein Zeiger auf den Freihandeingaben. Der Aufrufer hat diesen Zeiger aus einem vorherigen Aufruf von ExAllocateFromNPagedLookasideListabgerufen.
Rückgabewert
Nichts
Bemerkungen
Vorsicht
Ab Windows 11, Version 22H2, wurde diese Funktion von inline in exportierbar geändert. Wenn Sie daher ihren Treiber für die neueste Version von Windows erstellen, kann er 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 ExAllocateFromNPagedLookasideList. Er gibt einen vom Anrufer zugewiesenen Eintrag wieder an die Lookaside-Liste des Anrufers oder an nicht ausseitigen Pool zurück, wenn dieser Eintrag nicht mehr verwendet wird.
Derselbe Eintrag kann neu zugeordnet werden oder ein anderer Eintrag, der später mit einem nachfolgenden Aufruf von ExAllocateFromNPagedLookasideListzugewiesen wird. Der Benutzer der Lookaside-Liste kann solche Einträge dynamisch nach Bedarf zuordnen und freigeben, bis er ExDeleteNPagedLookasideListaufruft, wodurch alle ausstehenden Einträge in der Liste freigegeben werden, bevor er den Systemstatus für die angegebene Lookaside-Liste löscht und das Steuerelement zurückgibt.
Wenn die angegebene Lookaside-Liste die vom System festgelegte maximale Anzahl von Einträgen noch nicht erreicht hat, ExFreeToNPagedLookasideList den angegebenen Eintrag am Anfang der Liste einfügt. Andernfalls wird der Puffer bei Entry mithilfe der vom Aufrufer bereitgestellten Free Routine freigegeben, die bei der Initialisierung der Lookaside-Liste eingerichtet wurde, oder ExFreePool.
Weitere Informationen finden Sie unter Verwenden von Lookaside Lists.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Ab Windows 2000 verfügbar. |
| Zielplattform- | Desktop |
| Header- | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | <= DISPATCH_LEVEL |
| DDI-Complianceregeln | SpIrql(storport) |
Siehe auch
ExAllocateFromNPagedLookasideList