Macro NdisAllocateFromNPagedLookasideList (ndis.h)

  • Articolo

La funzione NdisAllocateFromNPagedLookasideList rimuove la prima voce dall'elenco lookaside specificato. Se l'elenco lookaside è attualmente vuoto, viene allocata una voce da un pool non con pagine.

Sintassi

void NdisAllocateFromNPagedLookasideList(
   _L
);

Parametri

_L

Puntatore alla testa dell'elenco lookaside da cui verrà allocata la voce. Il chiamante ha già inizializzato la testa elenco con Funzione NdisInitializeNPagedLookasideList .

Valore restituito

nessuno

Osservazioni

Se l'elenco lookaside non è vuoto, NdisAllocateFromNPagedLookasideList rimuove la prima voce dall'elenco e restituisce il relativo indirizzo al chiamante. Se l'elenco lookaside è vuoto, NdisAllocateFromNPagedLookasideList chiama la funzione Allocate , specificata nel parametro Allocate dell'oggetto Funzione NdisInitializeNPagedLookasideList , che il chiamante specificato all'inizializzazione dell'elenco, se presente o alloca una voce per conto del chiamante. NdisAllocateFromNPagedLookasideList restituisce NULL se la funzione Allocate fornita dal chiamante, se presente o se questa funzione stessa non può allocare una voce non di pagina.

Tutte le voci allocate da un elenco lookaside non di pagina sono di dimensioni fisse, specificate quando il driver ha originariamente chiamato NdisInitializeNPagedLookasideList. Di conseguenza, un elenco lookaside è particolarmente utile per i driver che devono allocare blocchi di dimensioni fisse in cui mantenere lo stato in risposta alla domanda di I/O dinamica. Ad esempio, qualsiasi driver NDIS orientato alla connessione potrebbe allocare le aree di contesto VC necessarie da un elenco lookaside come le macchine virtuali vengono create e rilasciare ogni voce di tale voce nell'elenco lookaside con l'oggetto Funzione NdisFreeToNPagedLookasideList quando ogni VC viene rimosso.

Requisiti

Requisito Valore
Client minimo supportato Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere NdisAllocateFromNPagedLookasideList (NDIS 5.1) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere NdisAllocateFromNPagedLookasideList (NDIS 5.1) in Windows XP.
Piattaforma di destinazione Desktop
Intestazione ndis.h (includere Ndis.h)
IRQL <= DISPATCH_LEVEL
Regole di conformità DDI Irql_Miscellaneous_Function(ndis), NdisAllocateFromNPagedLookasideList(ndis), NdisAllocateFromNPagedLookasideList_InitFail(ndis)

Vedi anche

NdisDeleteNPagedLookasideList NdisFreeToNPagedLookasideList NdisInitializeNPagedLookasideList