Skip to main content
傳回指定格式之單一並排資源圖格的形狀。

語法

參數

Dimension _In_
類型:XG_RESOURCE_DIMENSION
資源的維度,以 XG_RESOURCE_DIMENSION 列舉常數表示,例如未知、緩衝區、1D 紋理、2D 紋理或 3D 紋理。 Format _In_
類型:XG_FORMAT
格式,以 XG_FORMAT 列舉常數表示,例如 XG_FORMAT_R32G32B32_UINT。
  • 如果 Format 為 XG_FORMAT_UNKNOWN,則改用 BytesPerElement 參數,且 BytesPerElement 必須是 1、2、4、8 或 16 個位元組。
  • 如果 Format 不是 XG_FORMAT_UNKNOWN,則會忽略 BytesPerElement 的值,並由此函式計算。
BytesPerElement _In_
類型:UINT32
每個元素的位元組數,以 UINT32 表示。 SampleCount _In_
類型:UINT32
對於 Texture2D 以外的所有資源維度,SampleCount 必須為 1。對於 Texture2D,SampleCount 必須為 1、2、4 或 8。 pTileShapeInTexels _Out_opt_
類型:XG_TILE_SHAPE*
圖格形狀 (以紋素為單位),以指向 XG_TILE_SHAPE 結構的指標表示。如果 Format 為 XG_FORMAT_UNKNOWN,則 pTileShapeInTexels (若存在) 會填入零。 pTileShapeInElements _Out_opt_
類型:XG_TILE_SHAPE_ELEMENTS*
圖格形狀 (以元素為單位),以指向 XG_TILE_SHAPE_ELEMENTS 結構的指標表示。

傳回值

類型:HRESULT 如果成功,會傳回 S_OK;否則會傳回錯誤碼。如需錯誤碼清單,請參閱錯誤碼。

備註

此函式會傳回指定格式之單一並排資源圖格的形狀。圖格形狀會同時以紋素和元素為單位傳回。

需求

標頭: xg.h 程式庫: xg_x.lib 支援的平台: XBOX One 系列

另請參閱

XG 參考
Last modified on October 6, 2026