Função ExAllocateFromPagedLookasideList (wdm.h)
A rotina ExAllocateFromPagedLookasideList retorna um ponteiro para uma entrada paginada da lista lookaside fornecida ou retorna um ponteiro para uma entrada paginada recém-alocada.
Sintaxe
PVOID ExAllocateFromPagedLookasideList(
[in, out] PPAGED_LOOKASIDE_LIST Lookaside
);
Parâmetros
[in, out] Lookaside
Um ponteiro para a estrutura PAGED_LOOKASIDE_LIST para a lista lookaside, que o chamador já inicializou com ExInitializePagedLookasideList.
Retornar valor
ExAllocateFromPagedLookasideList retornará um ponteiro para uma entrada se um puder ser alocado. Caso contrário, ele retornará NULL.
Comentários
Cuidado
A partir de Windows 11, versão 22H2, essa função mudou de embutida para exportada. Como resultado, se você criar seu 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 do> Driver-Geral>.
Se a lista lookaside fornecida não estiver vazia, ExAllocateFromPagedLookasideList removerá a primeira entrada da lista e retornará um ponteiro para essa entrada. Caso contrário, ExAllocateFromPagedLookasideList chamará a rotina Allocate 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. O chamador deve liberar cada entrada com ExFreeToPagedLookasideList quando ela não estiver mais em uso.
Como as entradas em uma lista lookaside paginada são alocadas da memória paginável, elas não devem ser acessadas em um IRQL >= DISPATCH_LEVEL. Você pode usar ExAllocateFromNPagedLookasideList para criar uma lista lookaside com entradas não pagináveis.
No Windows 2000, os drivers devem usar a opção -D_WIN2K_COMPAT_SLIST_USAGE para vincular com êxito o código que usa ExAllocateFromPagedLookasideList.
Para obter mais informações, consulte Using Lookaside Listas.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível a partir do Windows 2000. |
| Plataforma de Destino | Universal |
| Cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Biblioteca | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |
Confira também
ExAllocateFromNPagedLookasideList