共用方式為


ExFreeToPagedLookasideList 函式 (wdm.h)

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

語法

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

參數

[in, out] Lookaside

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

[in] Entry

要釋放之專案的指標。 呼叫者從上述呼叫取得此指標,ExAllocateFromPagedLookasideList

傳回值

沒有

言論

謹慎

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

ExFreeToPagedLookasideList 是 exAllocateFromPagedLookasideList 的倒數。 它會將呼叫端配置的項目釋放回呼叫端的 lookaside 清單,或在該專案不再使用時釋放至分頁集區。

相同的專案可以重新配置,或者稍後可以使用後續呼叫exAllocateFromPagedLookasideList 來配置另一個專案。 lookaside 列表的使用者可以視需要動態配置和釋放這類專案,直到呼叫 ExDeletePagedLookasideList為止。 ExDeletePagedLookasideList 釋放清單中任何未完成的專案,再清除指定外觀清單的系統狀態並傳回控件。

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

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

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

要求

要求 價值
最低支援的用戶端 從 Windows 2000 開始提供。
目標平臺 普遍
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
連結庫 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

另請參閱

ExAllocateFromPagedLookasideList

ExDeletePagedLookasideList

ExInitializePagedLookasideList

PAGED_LOOKASIDE_LIST