Compartilhar via


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)

Confira também

NdisDeleteNPagedLookasideList NdisFreeToNPagedLookasideList NdisInitializeNPagedLookasideList