Функция 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

ExDeleteNPagedLookasideList

ExInitializeNPagedLookasideList

NPAGED_LOOKASIDE_LIST