Функция ExFreeToLookasideListEx (wdm.h)
Подпрограмма ExFreeToLookasideListEx вставляет запись в список lookaside или, если список заполнен, освобождает выделенное хранилище для записи.
Синтаксис
void ExFreeToLookasideListEx(
[in, out] PLOOKASIDE_LIST_EX Lookaside,
[in] PVOID Entry
);
Параметры
[in, out] Lookaside
Указатель на структуру LOOKASIDE_LIST_EX, описывающую список lookaside. Эта структура была инициализирована подпрограммой ExInitializeLookasideListEx.
[in] Entry
Указатель на запись lookaside-list, которая освобождается.
Возвращаемое значение
Никакой
Замечания
Осторожность
Начиная с Windows 11 версии 22H2 эта функция изменилась с встроенной на экспорт. В результате, если вы создаете драйвер, предназначенный для последней версии Windows, он не сможет загрузиться в более ранних версиях ОС. Чтобы изменить целевую версию ОС в Visual Studio, выберите "Свойства конфигурации">"Параметры драйвера">"Общие".
Эта подпрограмма освобождает запись lookaside-list, выделенную предыдущим вызовом подпрограммы ExAllocateFromLookasideListEx. ExFreeToLookasideListEx вставляет запись в указанный список lookaside, если пространство для записи доступно в списке. Если список заполнен (то есть он уже содержит максимальное количество записей, как определено операционной системой), ExFreeToLookasideListEx вызывает подпрограмму LookasideListFreeEx, чтобы освободить хранилище для указанной записи, если драйвер предоставил такую подпрограмму. В противном случае для освобождения записи используется подпрограмма размещения сделки по умолчанию.
Дополнительные сведения о списках lookaside см. в разделе Using Lookaside Lists.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Windows Vista и более поздних версиях Windows. |
| целевая платформа | Настольный |
| заголовка | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| библиотеки | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |