ExFreeToPagedLookasideList-Funktion (wdm.h)
Die ExFreeToPagedLookasideList Routine gibt einen seitenfähigen Eintrag in die angegebene Lookaside-Liste oder in einen ausgelagerten Pool zurück.
Syntax
void ExFreeToPagedLookasideList(
[in, out] PPAGED_LOOKASIDE_LIST Lookaside,
[in] PVOID Entry
);
Parameter
[in, out] Lookaside
Ein Zeiger auf die PAGED_LOOKASIDE_LIST-Struktur für die Lookaside-Liste, die der Aufrufer bereits mit ExInitializePagedLookasideListinitialisiert hat, den der Aufrufer bereits mit ExInitializePagedLookasideListinitialisiert hat.
[in] Entry
Ein Zeiger auf den Freihandeingaben. Der Aufrufer hat diesen Zeiger aus einem vorherigen Aufruf von ExAllocateFromPagedLookasideListabgerufen.
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.
ExFreeToPagedLookasideList ist der Kehrwert ExAllocateFromPagedLookasideList. Er gibt einen vom Anrufer zugewiesenen Eintrag zurück zur Lookaside-Liste des Anrufers oder zum ausgelagerten Pool frei, wenn dieser Eintrag nicht mehr verwendet wird.
Derselbe Eintrag kann neu zugewiesen werden, oder ein anderer Eintrag kann später mit einem nachfolgenden Aufruf von ExAllocateFromPagedLookasideListzugewiesen werden. Der Benutzer einer Lookaside-Liste kann solche Einträge nach Bedarf dynamisch zuordnen und freigeben, bis er ExDeletePagedLookasideListaufruft. ExDeletePagedLookasideList alle ausstehenden Einträge in der Liste los, bevor der Systemstatus für die angegebene Lookaside-Liste gelöscht und steuerelement zurückgegeben wird.
Wenn die angegebene Lookaside-Liste die vom System festgelegte maximale Anzahl von Einträgen noch nicht erreicht hat, ExFreeToPagedLookasideList den angegebenen Eintrag an der Vorderseite der Liste einfügt. Andernfalls wird der Puffer bei Eintrags- mithilfe der vom Aufrufer bereitgestellten Free Routine zurückgelassen, die bei der Initialisierung der Lookaside-Liste eingerichtet wurde, oder ExFreePool.
Unter Windows 2000 müssen Treiber den -D_WIN2K_COMPAT_SLIST_USAGE Switch verwenden, um Code erfolgreich zu verknüpfen, der ExFreeToPagedLookasideListverwendet.
Weitere Informationen finden Sie unter Verwenden von Lookaside Lists.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Ab Windows 2000 verfügbar. |
| Zielplattform- | Universal |
| Header- | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | <= APC_LEVEL |
Siehe auch
ExAllocateFromPagedLookasideList