Funzione ExFreeToNPagedLookasideList (wdm.h)
La routine ExFreeToNPagedLookasideList restituisce una voce non di pagina all'elenco lookaside specificato o al pool non di paging.
Sintassi
void ExFreeToNPagedLookasideList(
[in, out] PNPAGED_LOOKASIDE_LIST Lookaside,
[in] PVOID Entry
);
Parametri
[in, out] Lookaside
Puntatore alla struttura NPAGED_LOOKASIDE_LIST per l'elenco lookaside, che il chiamante già inizializzato con ExInitializeNPagedLookasideList.
[in] Entry
Puntatore alla voce da liberare. Il chiamante ha ottenuto questo puntatore da una chiamata precedente a ExAllocateFromNPagedLookasideList.
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.
ExFreeToNPagedLookasideList è il reciproco di ExAllocateFromNPagedLookasideList. Rilascia una voce allocata dal chiamante all'elenco lookaside del chiamante o al pool non a pagina quando tale voce non è più in uso.
La stessa voce può essere riallocata o un'altra voce allocata in un secondo momento con una chiamata successiva a ExAllocateFromNPagedLookasideList. L'utente dell'elenco lookaside può allocare e liberare tali voci in modo dinamico in base alle esigenze finché non chiama ExDeleteNPagedLookasideList, che rilascia tutte le voci in sospeso nell'elenco prima di cancellare lo stato di sistema per l'elenco lookaside specificato e restituisce il controllo.
Se l'elenco lookaside specificato non ha ancora raggiunto il numero massimo di voci determinato dal sistema, ExFreeToNPagedLookasideList inserisce la voce specificata all'inizio dell'elenco. In caso contrario, il buffer in corrispondenza del entry viene rilasciato nel pool non in pagine utilizzando la routine free fornita dal chiamante, se presente, configurata quando l'elenco lookaside è stato inizializzato o ExFreePool.
Per altre informazioni, vedere Using Lookaside Lists.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile a partire da Windows 2000. |
| piattaforma di destinazione | Desktop |
| intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| libreria | NtosKrnl.lib |
| dll | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |
| regole di conformità DDI | spIrql(storport) |
Vedere anche
exAllocateFromNPagedLookasideList