Função ExFreeToPagedLookasideList (wdm.h)
A rotina ExFreeToPagedLookasideList retorna uma entrada paginável para a lista lookaside fornecida ou para o pool paginado.
Sintaxe
void ExFreeToPagedLookasideList(
[in, out] PPAGED_LOOKASIDE_LIST Lookaside,
[in] PVOID Entry
);
Parâmetros
[in, out] Lookaside
Um ponteiro para a estrutura PAGED_LOOKASIDE_LIST para a lista lookaside, que o chamador já inicializou com ExInitializePagedLookasideList, que o chamador já inicializou com ExInitializePagedLookasideList.
[in] Entry
Um ponteiro para a entrada a ser liberada. O chamador obteve esse ponteiro de uma chamada anterior para ExAllocateFromPagedLookasideList.
Retornar valor
Nenhum
Comentários
Cuidado
A partir do Windows 11, versão 22H2, essa função mudou de embutida para exportada. Como resultado, se você criar o driver direcionado à versão mais recente do Windows, ele não será carregado 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>.
ExFreeToPagedLookasideList é a recíproca de ExAllocateFromPagedLookasideList. Ele libera uma entrada alocada pelo chamador de volta para a lista lookaside do chamador ou para o pool paginado quando essa entrada não está mais em uso.
A mesma entrada pode ser realocada ou outra entrada pode ser alocada posteriormente com uma chamada subsequente para ExAllocateFromPagedLookasideList. O usuário de uma lista lookaside pode alocar e liberar essas entradas dinamicamente, conforme necessário, até chamar ExDeletePagedLookasideList. ExDeletePagedLookasideList libera todas as entradas pendentes na lista antes de limpar o estado do sistema para a lista lookaside fornecida e retorna o controle.
Se a lista lookaside especificada ainda não tiver atingido o número máximo de entradas determinado pelo sistema, ExFreeToPagedLookasideList inserirá a entrada fornecida na frente da lista. Caso contrário, o buffer em Entry será liberado de volta para o pool de paginação usando a rotina Gratuita fornecida pelo chamador, se houver, que foi configurada quando a lista lookaside foi inicializada ou ExFreePool.
No Windows 2000, os drivers devem usar a opção -D_WIN2K_COMPAT_SLIST_USAGE para vincular com êxito o código que usa ExFreeToPagedLookasideList.
Para obter mais informações, consulte Usando Listas Lookaside.
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
ExAllocateFromPagedLookasideList