ExAllocateFromNPagedLo一sideList 函式 (wdm.h)
ExAllocateFromNPagedLo一sideList 例程會從指定的 lookaside 列表傳回非分頁專案的指標,或傳回新配置之非分頁專案的指標。
語法
PVOID ExAllocateFromNPagedLookasideList(
[in, out] PNPAGED_LOOKASIDE_LIST Lookaside
);
參數
[in, out] Lookaside
lookaside 列表 之NPAGED_LOOKASIDE_LIST 結構的指標,呼叫端已使用 ExInitializeNPagedLo以List 初始化。
傳回值
ExAllocateFromNPagedLo一sideList 會在可以配置專案時傳回專案的指標。 否則會傳回 NULL。
備註
警告
從 Windows 11 22H2 版開始,此函式從內嵌變更為匯出。 因此,如果您建置以最新版 Windows 為目標的驅動程式,則無法在舊版作業系統中載入。 若要在 Visual Studio 中變更目標 OS 版本,請選取 [組態屬性->驅動程式設定->一般]。
如果指定的 lookaside 清單不是空的, ExAllocateFromNPagedLo在清單 移除第一個專案,並傳回這個專案的指標。 否則,ExAllocateFromNPagedLo一sideList 會呼叫在清單初始化或 ExAllocatePoolWithTag 指定的 Allocate 例程,以傳回項目指標。
接著,呼叫端可以使用任何呼叫端決定的數據來設定傳回的專案。 例如,驅動程式可能會使用每個這類固定大小項目來設定命令區塊,例如 SCSI SRB,到特定類型 I/O 總線上的周邊裝置。 呼叫者應該在不再使用 ExFreeToNPagedLo可sideList 時釋放每個專案。
如需詳細資訊,請參閱使用 Lookaside 清單。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 從 Windows 2000 開始提供。 |
目標平台 | 桌面 |
標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
程式庫 | NtosKrnl.lib |
Dll | NtosKrnl.exe |
IRQL | <= DISPATCH_LEVEL |