Функция ExFreeToNPagedLookasideList (wdm.h)
Подпрограмма ExFreeToNPagedLookasideList возвращает несмежную запись в заданный список lookaside или в невыгодный пул.
Синтаксис
void ExFreeToNPagedLookasideList(
[in, out] PNPAGED_LOOKASIDE_LIST Lookaside,
[in] PVOID Entry
);
Параметры
[in, out] Lookaside
Указатель на структуру NPAGED_LOOKASIDE_LIST для списка lookaside, который вызывающий объект уже инициализировал с помощью ExInitializeNPagedLookasideList.
[in] Entry
Указатель на запись для освобождения. Вызывающий объект получил этот указатель из предыдущего вызова ExAllocateFromNPagedLookasideList.
Возвращаемое значение
None
Remarks
Внимание!
Начиная с Windows 11 версии 22H2 эта функция изменилась со встроенной на экспортируемую. В результате, если вы создаете драйвер, предназначенный для последней версии Windows, он не сможет загрузиться в более ранних версиях ОС. Чтобы изменить целевую версию ОС в Visual Studio, выберите Свойства конфигурации-Параметры> драйвера-Общие>.
ExFreeToNPagedLookasideList — это взаимное выражение ExAllocateFromNPagedLookasideList. Он освобождает запись, выделенную вызывающим объектом, обратно в список lookaside вызывающего абонента или в непагрегированный пул, когда эта запись больше не используется.
Ту же запись можно перераспределить или выделить другую запись позже с последующим вызовом ExAllocateFromNPagedLookasideList. Пользователь списка lookaside может динамически выделять и освобождать такие записи по мере необходимости, пока он не вызовет ExDeleteNPagedLookasideList, который отпустит все невыполненные записи в списке, прежде чем очистить состояние системы для заданного списка просмотра и возвратить управление.
Если указанный список lookaside еще не достиг максимального количества записей, определяемого системой, ExFreeToNPagedLookasideList вставляет данную запись в начало списка. В противном случае буфер в entry освобождается в непагрегированном пуле с помощью предоставленной вызывающей стороной бесплатной подпрограммы, которая была настроена при инициализации списка lookaside или ExFreePool.
Дополнительные сведения см. в разделе Использование lookaside Списки.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно начиная с Windows 2000. |
| Целевая платформа | Персональный компьютер |
| Верхняя часть | wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h) |
| Библиотека | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |
| Правила соответствия DDI | SpIrql(storport) |
См. также раздел
ExAllocateFromNPagedLookasideList