Funzione ExFreeToPagedLookasideList (wdm.h)

La routine ExFreeToPagedLookasideList restituisce una voce paginabile all'elenco lookaside specificato o al pool a pagina.

Sintassi

void ExFreeToPagedLookasideList(
  [in, out] PPAGED_LOOKASIDE_LIST Lookaside,
  [in]      PVOID                 Entry
);

Parametri

[in, out] Lookaside

Puntatore alla struttura PAGED_LOOKASIDE_LIST per l'elenco lookaside, che il chiamante già inizializzato con ExInitializePagedLookasideList, che il chiamante già inizializzato con ExInitializePagedLookasideList.

[in] Entry

Puntatore alla voce da liberare. Il chiamante ha ottenuto questo puntatore da una chiamata precedente a ExAllocateFromPagedLookasideList.

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>.

ExFreeToPagedLookasideList è il reciproco di ExAllocateFromPagedLookasideList. Rilascia una voce allocata dal chiamante all'elenco lookaside del chiamante o al pool a pagina quando tale voce non è più in uso.

La stessa voce può essere riallocata o un'altra voce può essere allocata in un secondo momento con una chiamata successiva a ExAllocateFromPagedLookasideList. L'utente di un elenco lookaside può allocare e liberare queste voci in modo dinamico, in base alle esigenze, fino a quando non chiama ExDeletePagedLookasideList. ExDeletePagedLookasideList rilascia tutte le voci in sospeso nell'elenco prima di cancellare lo stato del sistema per l'elenco lookaside specificato e restituisce il controllo.

Se l'elenco lookaside specificato non ha ancora raggiunto il numero massimo determinato dal sistema, ExFreeToPagedLookasideList inserisce la voce specificata all'inizio dell'elenco. In caso contrario, il buffer in Entry viene rilasciato al pool in pagina usando la routine gratuita fornita dal chiamante, se presente, configurata quando l'elenco lookaside è stato inizializzato o ExFreePool.

In Windows 2000 i driver devono usare il passaggio -D_WIN2K_COMPAT_SLIST_USAGE al codice di collegamento che usa ExFreeToPagedLookasideList.

Per altre informazioni, vedere Uso dell'Elenchi Lookaside.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 2000.
Piattaforma di destinazione	Universale
Intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Vedi anche

ExAllocateFromPagedLookasideList

ExDeletePagedLookasideList

ExInitializePagedLookasideList

PAGED_LOOKASIDE_LIST