Função ExFreeToLookasideListEx (wdm.h)
A rotina ExFreeToLookasideListEx insere uma entrada em uma lista lookaside ou, se a lista estiver completa, libera o armazenamento alocado para a entrada.
Sintaxe
void ExFreeToLookasideListEx(
[in, out] PLOOKASIDE_LIST_EX Lookaside,
[in] PVOID Entry
);
Parâmetros
[in, out] Lookaside
Um ponteiro para uma estrutura LOOKASIDE_LIST_EX que descreve uma lista lookaside. Essa estrutura foi inicializada anteriormente pela rotina exInitializeLookasideListEx.
[in] Entry
Um ponteiro para a entrada lookaside-list que está sendo liberada.
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.
Essa rotina libera uma entrada de lista lookaside que foi alocada por uma chamada anterior à rotina ExAllocateFromLookasideListEx. ExFreeToLookasideListEx insere a entrada na lista lookaside especificada, se o espaço para a entrada estiver disponível na lista. Se a lista estiver completa (ou seja, ela já contém o número máximo de entradas, conforme determinado pelo sistema operacional), ExFreeToLookasideListEx chamará a rotina LookasideListFreeEx para liberar o armazenamento da entrada especificada, se o driver tiver fornecido essa rotina. Caso contrário, uma rotina de desalocação padrão é usada para liberar a entrada.
Para obter mais informações sobre listas lookaside, consulte Using Lookaside Lists.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows Vista e versões posteriores do Windows. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| biblioteca | NtosKrnl.lib |
| de DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |