Macro NdisAllocateFromNPagedLookasideList (ndis.h)
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) |