ExFreeToNPagedLookasideList 函式 (wdm.h)
ExFreeToNPagedLookasideList 例程會將未分頁的專案傳回指定的 lookaside 清單或非頁面集區。
語法
void ExFreeToNPagedLookasideList(
[in, out] PNPAGED_LOOKASIDE_LIST Lookaside,
[in] PVOID Entry
);
參數
[in, out] Lookaside
lookaside 列表 NPAGED_LOOKASIDE_LIST 結構的指標,呼叫端已使用 exInitializeNPagedLookasideList 初始化。
[in] Entry
要釋放之專案的指標。 呼叫者從上述呼叫取得此指標,ExAllocateFromNPagedLookasideList。
傳回值
沒有
言論
謹慎
從 Windows 11 版本 22H2 開始,此函式已從內嵌變更為匯出。 因此,如果您建置以最新版 Windows 為目標的驅動程式,它將無法在舊版作系統中載入。 若要在 Visual Studio 中變更目標 OS 版本,請選取 [組態屬性->驅動程式設定->[一般]。
ExFreeToNPagedLookasideList 是 ExAllocateFromNPagedLookasideList的倒數。 它會將呼叫端配置的項目釋放回呼叫端的 lookaside 清單,或當該專案不再使用時,釋放到非分頁集區。
相同的專案可以重新配置或稍後配置另一個專案,並後續呼叫 exAllocateFromNPagedLookasideList 。 lookaside 清單的使用者可以視需要動態配置和釋放這類專案,直到呼叫 ExDeleteNPagedLookasideList,它會在清除指定外觀清單的系統狀態並傳回控件之前,釋放清單中任何未完成的專案。
如果指定的 lookaside 列表尚未達到系統決定的最大項目數,ExFreeToNPagedLookasideList 在清單前面插入指定的專案。 否則,Entry 的緩衝區會使用呼叫端提供的 Free 例程釋放至非分頁集區,如果有的話,則為在初始化 lookaside 列表時設定的緩衝區,或 ExFreePool。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 從 Windows 2000 開始提供。 |
目標平臺 | 桌面 |
標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
連結庫 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= DISPATCH_LEVEL |
DDI 合規性規則 | SpIrql(storport) |
另請參閱
ExAllocateFromNPagedLookasideList