Funzione ExFreeToLookasideListEx (wdm.h)
La routine ExFreeToLookasideListEx inserisce una voce in un elenco lookaside oppure, se l'elenco è completo, libera l'archiviazione allocata 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 che viene liberata.
Valore restituito
nessuno
Commenti
Attenzione
A partire da Windows 11 versione 22H2, questa funzione è cambiata da inline all'esportazione. 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 l'archiviazione per la voce specificata, se il driver ha fornito una routine di questo tipo. In caso contrario, viene usata una routine di deallocazione predefinita per liberare la voce.
Per altre informazioni sugli elenchi lookaside, vedere Uso di Lookaside Elenchi.
Requisiti
| 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 |