Macro NdisAllocateFromNPagedLookasideList (ndis.h)
A função NdisAllocateFromNPagedLookasideList remove a primeira entrada da cabeça da lista lookaside fornecida. Se a lista lookaside estiver vazia no momento, uma entrada será alocada do pool nãopagado.
Sintaxe
void NdisAllocateFromNPagedLookasideList(
_L
);
Parâmetros
_L
Um ponteiro para o cabeçalho da lista lookaside da qual a entrada será alocada. O chamador já inicializou o cabeçalho da lista com o função NdisInitializeNPagedLookasideList.
Valor de retorno
Nenhum
Observações
Se a lista lookaside não estiver vazia, NdisAllocateFromNPagedLookasideList removerá a primeira entrada da lista e retornará seu endereço para o chamador. Se a lista lookaside estiver vazia, NdisAllocateFromNPagedLookasideList chamará a função Allocate, especificada no parâmetro Allocate do função NdisInitializeNPagedLookasideList, que o chamador especificou na inicialização da lista, se houver, ou aloca uma entrada em nome do chamador. NdisAllocateFromNPagedLookasideList retornará NULL se a função Allocate fornecida pelo chamador, se houver, ou se essa função em si não puder alocar uma entrada não paga.
Todas as entradas alocadas de uma lista lookaside nãopagada são de um tamanho fixo, que foi especificado quando o driver originalmente chamado NdisInitializeNPagedLookasideList. Consequentemente, uma lista lookaside é particularmente útil para drivers que devem alocar blocos de tamanho fixo nos quais manter o estado em resposta à demanda dinâmica de E/S. Por exemplo, qualquer driver NDIS orientado à conexão pode alocar as áreas de contexto de VC de que precisa de uma lista lookaside à medida que os VCs são criados e liberar cada entrada desse tipo de volta para a lista lookaside com a função NdisFreeToNPagedLookasideList à medida que cada VC é derrubada.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Com suporte para drivers NDIS 6.0 e NDIS 5.1 (consulte NdisAllocateFromNPagedLookasideList (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte NdisAllocateFromNPagedLookasideList (NDIS 5.1)) no Windows XP. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | ndis.h (inclua Ndis.h) |
| IRQL | <= DISPATCH_LEVEL |
| regras de conformidade de DDI | Irql_Miscellaneous_Function(ndis), NdisAllocateFromNPagedLookasideList(ndis), NdisAllocateFromNPagedLookasideList_InitFail(ndis) |