XMemMapPhysicalPages
將 XMemAllocatePhysicalPages 所配置的頁面對應至虛擬位址空間。語法
參數
VirtualAddress _In_類型:PVOID 應對應頁面的位址。 NumberOfPages _In_
類型:ULONG_PTR PageArray 中的項目數。 PageArray _In_reads_opt_(NumberOfPages)
類型:PULONG_PTR 代表要對應之頁面的頁框編號陣列。
傳回值
類型:PVOID 實體頁面已對應的虛擬位址;如果對應失敗,則為 NULL。 如果對應失敗,請呼叫 GetLastError 以取得延伸錯誤資訊。備註
虛擬位址範圍必須先前已透過呼叫 XMemVirtualAlloc 保留,並搭配 MEM_RESERVE、MEM_64K_PAGES 或 MEM_2MB_PAGES 的頁面大小以及 XMEM_MAPPABLE 旗標。VirtualAlloc 所進行的 MEM_PHYSICAL 位址保留無法用來對應此記憶體。 如果虛擬位址範圍已有對應的頁面,這些頁面將會被取消對應。此外,可以為 PageArray 指定 NULL,以便解除認可記憶體區域。 XMemMapPhysicalPages 可用來在虛擬位址空間中多次對應相同的實體頁面。如果頁面被多次對應,多個對應必須指定相同的快取屬性 (如果未提供快取屬性,則隱含 CPU 一致;否則清單為 PAGE_NOCACHE 或 PAGE_WRITECOMBINE)。將實體頁面對應至以 MEM_2MB_PAGES 保留的記憶體時,實體頁面必須已使用 XMEM_2MB_CLUSTERS 配置。PageArray 參數應只包含每個 2MB 叢集的第一個實體頁面。
需求
標頭: xmem.h 程式庫: xmem.lib 支援的平台: XBOX One 系列主機和 XBOX Series 主機另請參閱
XMem 參考XMemVirtualAlloc
VirtualFree
XMemFreePhysicalPages
