Funzione ExAllocateFromNPagedLookasideList (wdm.h)

  • Articolo

La routine ExAllocateFromNPagedLookasideList restituisce un puntatore a una voce non impaginata dall'elenco lookaside specificato oppure restituisce un puntatore a una voce non di pagina appena allocata.

Sintassi

PVOID ExAllocateFromNPagedLookasideList(
  [in, out] PNPAGED_LOOKASIDE_LIST Lookaside
);

Parametri

[in, out] Lookaside

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

Valore restituito

ExAllocateFromNPagedLookasideList restituisce un puntatore a una voce se può essere allocata. In caso contrario, restituisce NULL.

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

Se l'elenco lookaside specificato non è vuoto, ExAllocateFromNPagedLookasideList rimuove la prima voce dall'elenco e restituisce un puntatore a questa voce. In caso contrario, ExAllocateFromNPagedLookasideList chiama la routine Allocate specificata all'inizializzazione dell'elenco o ExAllocatePoolWithTag per restituire un puntatore di ingresso.

Il chiamante può quindi configurare la voce restituita con tutti i dati determinati dal chiamante. Ad esempio, un driver può usare ogni voce di dimensioni fisse per configurare blocchi di comando, ad esempio srB SCSI, ai dispositivi periferici in un particolare tipo di bus di I/O. Il chiamante deve rilasciare ogni voce con ExFreeToNPagedLookasideList quando non è più in uso.

Per altre informazioni, vedere Uso dell'Elenchi Lookaside.

Requisiti

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

Vedi anche

ExAllocateFromPagedLookasideList

ExFreeToNPagedLookasideList

ExInitializeNPagedLookasideList

NPAGED_LOOKASIDE_LIST