Função ExAllocateFromNPagedLookasideList (wdm.h)
A rotina ExAllocateFromNPagedLookasideList retorna um ponteiro para uma entrada nãopagada da lista lookaside fornecida ou retorna um ponteiro para uma entrada nãopagada recém-alocada.
Sintaxe
PVOID ExAllocateFromNPagedLookasideList(
[in, out] PNPAGED_LOOKASIDE_LIST Lookaside
);
Parâmetros
[in, out] Lookaside
Um ponteiro para a estrutura NPAGED_LOOKASIDE_LIST para a lista lookaside, que o chamador já inicializou com ExInitializeNPagedLookasideList.
Valor de retorno
ExAllocateFromNPagedLookasideList retornará um ponteiro para uma entrada se puder ser alocado. Caso contrário, ele retornará NULL.
Observações
Cuidado
A partir do Windows 11, versão 22H2, essa função foi alterada de embutida para exportada. Como resultado, se você criar o driver visando a versão mais recente do Windows, ele falhará ao carregar em versões mais antigas do sistema operacional. Para alterar a versão do sistema operacional de destino no Visual Studio, selecione Propriedades de Configuração>Configurações de Driver>Geral.
Se a lista lookaside fornecida não estiver vazia, ExAllocateFromNPagedLookasideList removerá a primeira entrada da lista e retornará um ponteiro para essa entrada. Caso contrário, ExAllocateFromNPagedLookasideList chama a rotina Alocar especificada na inicialização da lista ou ExAllocatePoolWithTag para retornar um ponteiro de entrada.
Em seguida, o chamador pode configurar a entrada retornada com qualquer dado determinado pelo chamador. Por exemplo, um driver pode usar cada entrada de tamanho fixo para configurar blocos de comando, como SCSI SRBs, para dispositivos periféricos em um determinado tipo de barramento de E/S. O chamador deve liberar cada entrada com ExFreeToNPagedLookasideList quando não estiver mais em uso.
Para obter mais informações, consulte Usando listas lookaside.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível a partir do Windows 2000. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| biblioteca | NtosKrnl.lib |
| de DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |
Consulte também
ExAllocateFromPagedLookasideList