ExFreeToPagedLo (wdm.h)

ExFreeToPagedLookasideList 例程會將可分頁的專案傳回至指定的 lookaside 清單或分頁集區。

語法

void ExFreeToPagedLookasideList(
  [in, out] PPAGED_LOOKASIDE_LIST Lookaside,
  [in]      PVOID                 Entry
);

參數

[in, out] Lookaside

lookaside 列表的 PAGED_LOOKASIDE_LIST 結構的指標，呼叫端已使用 ExInitializePagedLoitisideList 初始化，呼叫端已使用 ExInitializePagedLoitisideList 初始化。

[in] Entry

要釋放之專案的指標。 呼叫端從先前對 ExAllocateFromPagedLookasideList 的呼叫取得此指標。

傳回值

無

備註

警告

從 Windows 11 22H2 版開始，此函式已從內嵌變更為匯出。 因此，如果您建置以最新版 Windows 為目標的驅動程式，則無法在舊版作業系統中載入。 若要在 Visual Studio 中變更目標 OS 版本，請選取 [組態屬性->驅動程式設定->一般]。

ExFreeToPagedLookasideList 是 ExAllocateFromPagedLookasideList 的相互關係。 它會將該專案不再使用時，將呼叫端配置的專案釋放回呼叫端的外觀清單或分頁集區。

您可以重新配置相同的專案，或稍後再配置另一個專案，並接著呼叫 ExAllocateFromPagedLookasideList。 Lookaside 清單的使用者可以視需要動態配置並釋放這類專案，直到呼叫 ExDeletePagedLookasideList 為止。 ExDeletePagedLookasideList 會在清除指定外觀清單的系統狀態並傳回控件之前，釋放清單中任何未完成的專案。

如果指定的 lookaside 列表尚未達到系統決定的項目數目上限， ExFreeToPagedLookasideList 會在清單前面插入指定的專案。 否則， Entry 上的緩衝區會使用呼叫端提供的 Free 例程釋放回分頁集區，如果有的話，當 lookaside 清單初始化或 ExFreePool 時已設定。

在 Windows 2000 上，驅動程式必須使用 -D_WIN2K_COMPAT_SLIST_USAGE 參數，才能成功連結使用 ExFreeToPagedLofreesideList 的程序代碼。

如需詳細資訊，請參閱使用 Lookaside 清單。

規格需求

需求	值
最低支援的用戶端	從 Windows 2000 開始提供。
目標平台	Universal
標頭	wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe
IRQL	<= APC_LEVEL

另請參閱

ExAllocateFromPagedLookasideList

ExDeletePagedLookasideList

ExInitializePagedLookasideList

PAGED_LOOKASIDE_LIST