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

ExDeletePagedLookasideList

ExInitializePagedLookasideList

PAGED_LOOKASIDE_LIST