mmMapIoSpaceEx 函式 (wdm.h)

MmMapIoSpaceEx 例程會使用指定的頁面保護，將指定的實體位址範圍對應至非分頁系統空間。

語法

PVOID MmMapIoSpaceEx(
  [in] PHYSICAL_ADDRESS PhysicalAddress,
  [in] SIZE_T           NumberOfBytes,
  [in] ULONG            Protect
);

參數

[in] PhysicalAddress

指定要對應的 I/O 範圍的起始實體位址。

[in] NumberOfBytes

指定大於零的值，指出要對應的位元元組數目。

[in] Protect

旗標位，指定要用於對應範圍的保護。 呼叫端必須在 Protect 參數中設定下列其中一個旗標位。

旗標位	意義
PAGE_READONLY	對應的範圍只能讀取，不能寫入。
PAGE_READWRITE	對應的範圍可以讀取或寫入。
PAGE_EXECUTE	可以執行對應的範圍，但無法讀取或寫入。
PAGE_EXECUTE_READ	可以執行或讀取對應的範圍，但無法寫入。
PAGE_EXECUTE_READWRITE	對應的範圍可以執行、讀取或寫入。

 

此外，呼叫端可以在 Protect 參數中設定一個 (，但不能同時設定下列選擇性旗標位) 。

旗標位	意義
PAGE_NOCACHE	指定非快取記憶體。
PAGE_WRITECOMBINE	指定寫入合併的記憶體 (處理器不應快取記憶體，但處理器) 可以合併寫入記憶體。

傳回值

MmMapIoSpaceEx 會傳回對應範圍之基底實體位址的基底虛擬位址。 如果對應範圍的空間不足，則會傳回 NULL。

備註

如果驅動程式在CM_PARTIAL_RESOURCE_DESCRIPTOR結構中收到 CmResourceTypeMemory 類型的翻譯資源，則驅動程式必須在裝置啟動期間呼叫此例程。 MmMapIoSpaceEx 會將資源清單中傳回的實體位址對應至虛擬位址，讓驅動程式可以存取裝置註冊。

例如，配置長期 I/O 緩衝區的 PIO 裝置驅動程式可以呼叫此例程，讓這類緩衝區可供存取，或讓裝置記憶體可供存取。

如需使用此例程的詳細資訊，請參閱 將 Bus-Relative 位址對應至虛擬位址。

規格需求

需求	值
最低支援的用戶端	從 Windows 10 開始提供。
目標平台	Universal
標頭	wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe
IRQL	<=DISPATCH_LEVEL

另請參閱

MmAllocateContiguousMemory

MmAllocateNonCachedMemory

MmMapLockedPages

MmUnmapIoSpace