Функция 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.
Возвращаемое значение
Никакой
Замечания
Осторожность
Начиная с Windows 11 версии 22H2 эта функция изменилась с встроенной на экспорт. В результате, если вы создаете драйвер, предназначенный для последней версии Windows, он не сможет загрузиться в более ранних версиях ОС. Чтобы изменить целевую версию ОС в Visual Studio, выберите "Свойства конфигурации">"Параметры драйвера">"Общие".
ExFreeToNPagedLookasideList является взаимной ExAllocateFromNPagedLookasideList. Он освобождает запись, выделенную вызывающим объектом, обратно в список lookaside вызывающего или в непакованный пул, когда эта запись больше не используется.
Ту же запись можно перераспределить или еще одну запись, выделенную позже, с последующим вызовом ExAllocateFromNPagedLookasideList. Пользователь списка lookaside может динамически выделять и освобождать такие записи по мере необходимости, пока он не вызывает ExDeleteNPagedLookasideList, который освобождает все невыполненные записи в списке перед очисткой состояния системы для заданного списка lookaside и возвращает элемент управления.
Если указанный список lookaside еще не достиг установленного системой максимального количества записей, ExFreeToNPagedLookasideList вставляет указанную запись в передней части списка. В противном случае буфер в записи освобождается в непагаченном пуле с помощью подпрограммы, предоставленной вызывающим бесплатной, которая была настроена при инициализации списка lookaside или ExFreePool.
Дополнительные сведения см. в разделе Using Lookaside Lists.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно начиная с Windows 2000. |
| целевая платформа | Настольный |
| заголовка | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| библиотеки | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |
| правил соответствия DDI | spIrql(storport) |
См. также
ExAllocateFromNPagedLookasideList