MapViewOfFileNuma2 函式 (memoryapi.h)
將檔案或頁面檔支援的區段檢視對應至指定進程的地址空間。
語法
PVOID MapViewOfFileNuma2(
[in] HANDLE FileMappingHandle,
[in] HANDLE ProcessHandle,
[in] ULONG64 Offset,
[in, optional] PVOID BaseAddress,
[in] SIZE_T ViewSize,
[in] ULONG AllocationType,
[in] ULONG PageProtection,
[in] ULONG PreferredNode
);
參數
[in] FileMappingHandle
要對應至指定進程的位址空間之區段的 HANDLE 。
[in] ProcessHandle
將對應區段之進程的 HANDLE 。
[in] Offset
區段開頭的位移。 這必須對齊 64k。
[in, optional] BaseAddress
檢視所需的基位址。 位址會四捨五入至最接近的 64k 界限。 如果此參數為 NULL,則系統會挑選基位址。
[in] ViewSize
要對應的位元組數目。 0 (0 的值,) 會指定整個區段要對應。
[in] AllocationType
配置的類型。 此參數可以是零 (0) 或下列其中一個常數值:
- MEM_RESERVE - 地圖保留檢視
- MEM_LARGE_PAGES - 對應大型頁面檢視
[in] PageProtection
所需的頁面保護。
對於使用 SEC_IMAGE 屬性建立的檔案對應物件, PageProtection 參數沒有任何作用,而且應該設定為任何有效的值,例如 PAGE_READONLY。
[in] PreferredNode
此記憶體慣用的 NUMA 節點。
傳回值
如果成功,則會傳回對應檢視的基位址。 否則,會使用 GetLastError 傳回 NULL 和擴充錯誤狀態。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 10 版本 1703 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2016 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | memoryapi.h (包括 Windows.h、Memoryapi.h) |
程式庫 | Onecore.lib;Onecoreuap.lib |
Dll | Api-ms-win-core-memory-l1-1-5.dll |