Função ExFreeToPagedLookasideList (wdm.h)
A rotina ExFreeToPagedLookasideList retorna uma entrada paginável para a lista lookaside fornecida ou para o pool de páginas.
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 .
Valor de retorno
Nenhum
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.
ExFreeToPagedLookasideList é a recíproca de ExAllocateFromPagedLookasideList . Ele libera uma entrada alocada por chamador de volta para a lista lookaside do chamador ou para o pool de páginas 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 retornar o controle.
Se a lista lookaside especificada ainda não atingiu o número máximo de entradas determinado pelo sistema, ExFreeToPagedLookasideList inserirá a entrada fornecida na frente da lista. Caso contrário, o buffer no Entry será liberado de volta para o pool de páginas usando a rotina de 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 |
|---|---|
| de cliente com suporte mínimo | Disponível a partir do Windows 2000. |
| da Plataforma de Destino | Universal |
| cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| biblioteca | NtosKrnl.lib |
| de DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |
Consulte também
ExAllocateFromPagedLookasideList