ExFreeToLookasideListEx-Funktion (wdm.h)

Die ExFreeToLookasideListEx-Routine fügt einen Eintrag in eine Suchliste ein oder gibt den zugewiesenen Speicher für den Eintrag frei, wenn die Liste voll ist.

Syntax

void ExFreeToLookasideListEx(
  [in, out] PLOOKASIDE_LIST_EX Lookaside,
  [in]      PVOID              Entry
);

Parameter

[in, out] Lookaside

Ein Zeiger auf eine LOOKASIDE_LIST_EX Struktur, die eine Suchliste beschreibt. Diese Struktur wurde zuvor von der ExInitializeLookasideListEx-Routine initialisiert.

[in] Entry

Ein Zeiger auf den Suchlisteneintrag, der freigegeben wird.

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.

Diese Routine gibt einen Lookaside-List-Eintrag frei, der von einem vorherigen Aufruf der ExAllocateFromLookasideListEx-Routine zugeordnet wurde. ExFreeToLookasideListEx fügt den Eintrag in die angegebene Suchliste ein, wenn Speicherplatz für den Eintrag in der Liste verfügbar ist. Wenn die Liste voll ist (d. h. sie enthält bereits die maximale Anzahl von Einträgen, wie vom Betriebssystem festgelegt), ruft ExFreeToLookasideListEx die LookasideListFreeEx-Routine auf, um den Speicher für den angegebenen Eintrag freizusetzen, wenn der Treiber eine solche Routine bereitgestellt hat. Andernfalls wird eine standardmäßige Deallocation-Routine verwendet, um den Eintrag freizusetzen.

Weitere Informationen zu Lookaside-Listen finden Sie unter Verwenden von Lookaside Listen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und späteren Windows-Versionen.
Zielplattform	Desktop
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL

Weitere Informationen

ExAllocateFromLookasideListEx

ExInitializeLookasideListEx

LOOKASIDE_LIST_EX