ExFreeToPagedLookasideList-Funktion (wdm.h)
Die ExFreeToPagedLookasideList-Routine gibt einen auslagerungsfähigen Eintrag in die angegebene Lookaside-Liste oder den 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 Suchliste, die der Aufrufer bereits mit ExInitializePagedLookasideList initialisiert hat, die der Aufrufer bereits mit ExInitializePagedLookasideList initialisiert hat.
[in] Entry
Ein Zeiger auf den zu befreienden Eintrag. Der Aufrufer hat diesen Zeiger von einem vorherigen Aufruf von ExAllocateFromPagedLookasideList abgerufen.
Rückgabewert
Keine
Bemerkungen
Achtung
Ab Windows 11 Version 22H2 wurde diese Funktion von inline zu exportiert. Wenn Sie ihren Treiber für die neueste Windows-Version 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.
ExFreeToPagedLookasideList ist die Kehrseite von ExAllocateFromPagedLookasideList. Es gibt einen vom Anrufer zugewiesenen Eintrag zurück in die Lookaside-Liste des Aufrufers oder an einen ausgelagerten Pool, wenn dieser Eintrag nicht mehr verwendet wird.
Derselbe Eintrag kann neu zugeordnet werden, oder ein anderer Eintrag kann später mit einem nachfolgenden Aufruf von ExAllocateFromPagedLookasideList zugeordnet werden. Der Benutzer einer Lookaside-Liste kann solche Einträge dynamisch nach Bedarf zuordnen und freigeben, bis exDeletePagedLookasideList aufgerufen wird. ExDeletePagedLookasideList gibt alle ausstehenden Einträge in der Liste frei, bevor der Systemstatus für die angegebene Lookaside-Liste gelöscht und das Steuerelement zurückgegeben wird.
Wenn die angegebene Suchliste die vom System festgelegte maximale Anzahl von Einträgen noch nicht erreicht hat, fügt ExFreeToPagedLookasideList den angegebenen Eintrag an der Spitze der Liste ein. Andernfalls wird der Puffer bei Entry mithilfe der vom Aufrufer bereitgestellten Free-Routine (falls vorhanden) wieder in den Auslagerungspool freigegeben, die beim Initialisieren der Lookaside-Liste oder ExFreePool eingerichtet wurde.
Unter Windows 2000 müssen Treiber den Switch -D_WIN2K_COMPAT_SLIST_USAGE verwenden, um Code erfolgreich zu verknüpfen, der ExFreeToPagedLookasideList verwendet.
Weitere Informationen finden Sie unter Verwenden von Lookaside Listen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar ab Windows 2000. |
| Zielplattform | Universell |
| Header | wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |
Weitere Informationen
ExAllocateFromPagedLookasideList