Função ExFreeToNPagedLookasideList (wdm.h)
A rotina ExFreeToNPagedLookasideList retorna uma entrada nãopagada para a lista lookaside fornecida ou para o pool nãopagado.
Sintaxe
void ExFreeToNPagedLookasideList(
[in, out] PNPAGED_LOOKASIDE_LIST Lookaside,
[in] PVOID Entry
);
Parâmetros
[in, out] Lookaside
Um ponteiro para a estrutura NPAGED_LOOKASIDE_LIST para a lista lookaside, que o chamador já inicializou com ExInitializeNPagedLookasideList.
[in] Entry
Um ponteiro para a entrada a ser liberada. O chamador obteve esse ponteiro de uma chamada anterior para ExAllocateFromNPagedLookasideList.
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>.
ExFreeToNPagedLookasideList é a recíproca de ExAllocateFromNPagedLookasideList. Ele libera uma entrada alocada pelo chamador de volta para a lista lookaside do chamador ou para o pool nãopagado quando essa entrada não está mais em uso.
A mesma entrada pode ser realocada ou outra entrada alocada posteriormente com uma chamada subsequente para ExAllocateFromNPagedLookasideList. O usuário da lista lookaside pode alocar e liberar essas entradas dinamicamente conforme necessário até chamar ExDeleteNPagedLookasideList, que 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 tiver atingido o número máximo de entradas determinado pelo sistema, ExFreeToNPagedLookasideList inserirá a entrada fornecida na frente da lista. Caso contrário, o buffer em Entry é liberado para o pool nãopagado usando a rotina Gratuita fornecida pelo chamador, se houver, que foi configurada quando a lista lookaside foi inicializada ou ExFreePool.
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 | Área de Trabalho |
| Cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Biblioteca | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |
| Regras de conformidade da DDI | SpIrql(storport) |
Confira também
ExAllocateFromNPagedLookasideList