Funzione ExFreeToLookasideListEx (wdm.h)
La routine ExFreeToLookasideListEx inserisce una voce in un elenco lookaside oppure, se l'elenco è pieno, libera lo spazio di archiviazione allocato per la voce.
Sintassi
void ExFreeToLookasideListEx(
[in, out] PLOOKASIDE_LIST_EX Lookaside,
[in] PVOID Entry
);
Parametri
[in, out] Lookaside
Puntatore a una struttura LOOKASIDE_LIST_EX che descrive un elenco lookaside. Questa struttura è stata inizializzata in precedenza dalla routine ExInitializeLookasideListEx.
[in] Entry
Puntatore alla voce lookaside-list liberata.
Valore restituito
Nessuno
Osservazioni
Cautela
A partire da Windows 11 versione 22H2, questa funzione è cambiata da inline a esportata. Di conseguenza, se si compila il driver destinato alla versione più recente di Windows, non verrà caricato nelle versioni precedenti del sistema operativo. Per modificare la versione del sistema operativo di destinazione in Visual Studio, selezionare Proprietà di configurazione- Impostazioni driver>->Generale.
Questa routine libera una voce lookaside-list allocata da una chiamata precedente alla routine ExAllocateFromLookasideListEx. ExFreeToLookasideListEx inserisce la voce nell'elenco lookaside specificato, se lo spazio per la voce è disponibile nell'elenco. Se l'elenco è completo (ovvero contiene già il numero massimo di voci, come determinato dal sistema operativo), ExFreeToLookasideListEx chiama la routine LookasideListFreeEx per liberare lo spazio di archiviazione per la voce specificata, se il driver ha fornito una routine di questo tipo. In caso contrario, viene utilizzata una routine di deallocazione predefinita per liberare la voce.
Per altre informazioni sugli elenchi lookaside, vedere Using Lookaside Lists.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Windows Vista e versioni successive di Windows. |
| piattaforma di destinazione | Desktop |
| intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| libreria | NtosKrnl.lib |
| dll | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |