共用方式為


ExAllocateFromNPagedLookasideList 函式 (wdm.h)

ExAllocateFromNPagedLookasideList 例程會從指定的 lookaside 列表中傳回非分頁項目指標,或傳回新配置之非分頁專案的指標。

語法

PVOID ExAllocateFromNPagedLookasideList(
  [in, out] PNPAGED_LOOKASIDE_LIST Lookaside
);

參數

[in, out] Lookaside

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

傳回值

ExAllocateFromNPagedLookasideList 如果可以配置專案,則會傳回專案的指標。 否則,它會傳回NULL

言論

謹慎

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

如果指定的 lookaside 清單不是空的,ExAllocateFromNPagedLookasideList 從清單中移除第一個專案,並傳回這個專案的指標。 否則,ExAllocateFromNPagedLookasideList 呼叫在清單初始化中指定的 Allocate 例程,或 ExAllocatePoolWithTag 傳回項目指標。

接著,呼叫端可以使用任何呼叫端決定的數據來設定傳回的專案。 例如,驅動程式可能會使用每個這類固定大小的專案,將命令區塊,例如 SCSI SRB 設定為特定 I/O 總線類型的周邊裝置。 呼叫端應該釋放每個專案,其中含有 ExFreeToNPagedLookasideList 不再使用。

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

要求

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

另請參閱

ExAllocateFromPagedLookasideList

ExFreeToNPagedLookasideList

ExInitializeNPagedLookasideList

NPAGED_LOOKASIDE_LIST