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 dal pool non di paging.
Sintassi
void NdisAllocateFromNPagedLookasideList(
_L
);
Parametri
_L
Puntatore all'inizio dell'elenco lookaside da cui verrà allocata la voce. Il chiamante ha già inizializzato l'intestazione dell'elenco con funzione NdisInitializeNPagedLookasideList.
Valore restituito
Nessuno
Osservazioni
Se l'elenco lookaside non è vuoto, NdisAllocateFromNPagedLookasideList rimuove la prima voce dall'elenco e ne restituisce l'indirizzo al chiamante. Se l'elenco lookaside è vuoto, NdisAllocateFromNPagedLookasideList chiama la funzione Allocate, specificata nel parametro allocate del parametro funzione NdisInitializeNPagedLookasideList, che il chiamante specificato all'inizializzazione dell'elenco, se presente, o alloca una voce per conto del chiamante. NdisAllocateFromNPagedLookasideList restituisce NULL se il chiamante fornito funzione Allocate, se presente, o se questa funzione 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 originariamente denominato NdisInitializeNPagedLookasideList. Di conseguenza, un elenco lookaside è particolarmente utile per i driver che devono allocare blocchi a dimensione fissa 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 man mano che vengono create le schede virtuali e rilasciare ogni voce di questo tipo all'elenco lookaside con il NdisFreeToNPagedLookasideList funzione quando ogni VC viene rimosso.
Fabbisogno
| 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 (include Ndis.h) |
| IRQL | <= DISPATCH_LEVEL |
| regole di conformità DDI | Irql_Miscellaneous_Function(ndis), NdisAllocateFromNPagedLookasideList(ndis), NdisAllocateFromNPagedLookasideList_InitFail(ndis) |