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 .
Retornar valor
Nenhum
Comentários
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ão paga 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 a conexões 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 o A função NdisFreeToNPagedLookasideList como cada VC é interrompida.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | 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. |
| 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) |