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

旗標的位，表示要為頁面設定的保護。 可能的值為PAGE_Xxx Wdm.h 中定義的常數。

[in] DriverRoutine

驅動程式提供的回呼例 程指標， (MM_MDL_ROUTINE 對應 MDL 之後叫用的) 。

[in] DriverContext

驅動程式定義內容的指標。 驅動程式的回呼函式可以在驅動程式內容中儲存任何狀態資訊，然後在叫用回呼時檢查值。

傳回值

如果叫用 DriverRoutine 所指向的回呼函式，此函式會傳回STATUS_SUCCESS。 如果無法對應 MDL 或無法叫用回呼函式，函式會傳回適當的 NTSTATUS 值。

備註

MmMapMdl 會對應 MDL (如果尚未對應) 、叫用回呼，然後在建立) 時釋放對應 (。 呼叫端不需要執行任何清除。

規格需求

需求 值
最低支援的用戶端 Windows 10 (版本 1709)
最低支援的伺服器 Windows Server 2016
目標平台 Windows
標頭 wdm.h
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe (核心模式)
IRQL <=DISPATCH_LEVEL

另請參閱

MM_MDL_ROUTINE