MmMapMdl 函式 (wdm.h)
此函式會將記憶體描述元清單 (MDL) 所描述的實體頁面對應至系統虛擬位址空間。
語法
NTSTATUS MmMapMdl(
[in] PMDL MemoryDescriptorList,
[in] ULONG Protection,
[in] PMM_MDL_ROUTINE DriverRoutine,
[in] PVOID DriverContext
);
參數
[in] MemoryDescriptorList
有效 MDL 的指標。
[in] Protection
旗標的位,表示要為頁面設定的保護。 可能的值為 Wdm.h 中定義的PAGE_Xxx常數。
[in] DriverRoutine
驅動程式提供的回呼例程指標(MM_MDL_ROUTINE),在對應 MDL 之後叫用。
[in] DriverContext
驅動程式定義內容的指標。 驅動程式的回呼函式可以在驅動程式內容中儲存任何狀態資訊,然後在叫用回呼時檢查值。
傳回值
如果叫用 driverRoutine 所指向的回呼函式,則此函式會傳回STATUS_SUCCESS。 如果無法對應 MDL 或無法叫用回呼函式,函式會傳回適當的 NTSTATUS 值。
言論
MmMapMdl 對應 MDL (如果尚未對應),會叫用回呼,然後釋放對應(如果已建立對應)。 呼叫端不需要執行任何清除。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 10 版本 1709 |
支援的最低伺服器 | Windows Server 2016 |
目標平臺 | 窗戶 |
標頭 | wdm.h |
連結庫 | NtosKrnl.lib |
DLL | NtosKrnl.exe (核心模式) |
IRQL | <=DISPATCH_LEVEL |