Skip to main content

XGMemoryLayout::CreateMapping 方法 (XBOX One 系列)

以指定的名稱建立新的對應。

語法

參數

strName   _In_z_
類型: WCHAR*
新對應的名稱。 pMapping   _Out_
類型: XGMemoryLayoutMapping *
新的對應,以指向 XGMemoryLayoutMapping 結構的指標表示。 AlignmentBytes   _In_
類型: UINT32
對應虛擬位址的對齊方式 (以位元組為單位)。指定 0 以使用預設對齊方式 XG_GPU_PAGE_SIZE_BYTES。

傳回值

類型: HRESULT S_OK、E_INVALIDARG 或 E_OUTOFMEMORY。

備註

以指定的名稱建立新的對應。將 AlignmentBytes 設為 0,即可使用預設對齊方式 XG_GPU_PAGE_SIZE_BYTES 作為對應的虛擬位址對齊方式。 此常數代表 XG GPU 頁面的大小 (以位元組為單位)。 此大小通常為 64 KB,可透過 XGMemoryLayout::GetPageSizeBytes 方法確認。 新的對應會建立為指向 XGMemoryLayoutMapping 結構的指標。此方法類似 XGMemoryLayout::MapFromPattern 方法,差別在於 MapFromPattern 會使用以位元組陣列傳遞的預先定義模式來對應頁面。

需求

標頭: xgmemory.h 支援的平台: XBOX One 系列

另請參閱

XGMemoryLayout
Last modified on October 6, 2026