Share via


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

另請參閱

MapViewOfFile

MapViewOfFileNuma