跳轉到主要內容
取得並排資源如何分割成圖格的相關資訊。

語法

參數

pTiledResource [in]
類型:ID3D12Resource *
指定要取得其資訊的並排 ID3D12Resource。 pNumTilesForEntireResource [out, optional]
類型:UINT *
指向變數的指標,該變數會接收儲存整個並排資源所需的圖格數目。 pPackedMipDesc [out, optional]
類型:D3D12_PACKED_MIP_INFO *
指向 D3D12_PACKED_MIP_INFO 結構的指標,GetResourceTiling 會在其中填入並排資源的 MIP 對應如何封裝的相關資訊。 pStandardTileShapeForNonPackedMips [out, optional]
類型:D3D12_TILE_SHAPE *
指定 D3D12_TILE_SHAPE 結構,GetResourceTiling 會在其中填入圖格形狀的相關資訊。這是關於像素如何容納於圖格中的資訊,與並排資源的維度無關,不包括封裝的 MIP 對應。如果整個並排資源都已封裝,此參數就沒有意義,因為並排資源沒有為封裝的 MIP 對應定義配置。在此情況下,GetResourceTiling 會將 D3D12_TILE_SHAPE 的成員設為零。 pNumSubresourceTilings [in, out, optional]
類型:UINT *
指向變數的指標,該變數包含子資源中的圖格數目。在輸入時,這是要查詢其並排的子資源數目;在輸出時,這是實際在 pSubresourceTilingsForNonPackedMips 擷取到的數目 (限制在可用的範圍內)。 FirstSubresourceTilingToGet [in]
類型:UINT
要取得的第一個子資源圖格的編號。如果 pNumSubresourceTilings 所指向的數目為 0,GetResourceTiling 會忽略此參數。 pSubresourceTilingsForNonPackedMips [out]
類型:D3D12_SUBRESOURCE_TILING *
指定 D3D12_SUBRESOURCE_TILING 結構,GetResourceTiling 會在其中填入子資源圖格的相關資訊。如果子資源圖格是封裝 MIP 對應的一部分,GetResourceTiling 會將 D3D12_SUBRESOURCE_TILING 的成員設為零,但 StartTileIndexInOverallResource 成員除外,GetResourceTiling 會將其設為 D3D12_PACKED_TILE (0xffffffff)。D3D12_PACKED_TILE 常數表示整個 D3D12_SUBRESOURCE_TILING 結構在此情況下沒有意義,而應套用 pPackedMipDesc 參數所指向的資訊。

傳回值

類型:void 無。

備註

若要在計算堆積大小及呼叫 CreatePlacedResource 時估計所需紋理的總資源大小,請使用 GetResourceAllocationInfo,而不是 GetResourceTiling。 GetResourceTiling 無法用於此用途。 如需並排資源的詳細資訊,請參閱體積並排資源。

需求

標頭: d3d12_xs.h 或 d3d12_x.h
程式庫: d3d12_xs.lib 或 d3d12_x.lib
支援的平台: XBOX Series 主機和 XBOX One 系列主機

另請參閱

ID3D12Device 子資源
最後修改於 2026年10月6日