Skip to main content
获取有关平铺资源如何分解为平铺的信息。

语法

参数

pTiledResource [in]
类型:ID3D12Resource *
指定要获取信息的平铺 ID3D12Resource pNumTilesForEntireResource [out, optional]
类型:UINT *
指向变量的指针,该变量接收存储整个平铺资源所需的平铺数。 pPackedMipDesc [out, optional]
类型:D3D12_PACKED_MIP_INFO *
指向 D3D12_PACKED_MIP_INFO 结构体的指针,GetResourceTiling 使用有关平铺资源的 mipmap 如何打包的信息填充该结构体。 pStandardTileShapeForNonPackedMips [out, optional]
类型:D3D12_TILE_SHAPE *
指定 D3D12_TILE_SHAPE 结构体,GetResourceTiling 使用有关平铺形状的信息填充该结构体。这是有关像素如何适应平铺的信息,独立于平铺资源的维度,不包括打包的 mipmap。如果整个平铺资源都被打包,则此参数无意义,因为平铺资源没有为打包的 mipmap 定义布局。在这种情况下,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 使用有关子资源平铺的信息填充该结构体。如果子资源平铺是打包 mipmap 的一部分,则 GetResourceTiling 将 D3D12_SUBRESOURCE_TILING 的成员设置为零,但 StartTileIndexInOverallResource 成员除外,GetResourceTiling 将该成员设置为 D3D12_PACKED_TILE (0xffffffff)。D3D12_PACKED_TILE 常量表示整个 D3D12_SUBRESOURCE_TILING 结构体在此情况下无意义,并且 pPackedMipDesc 参数指向的信息适用。

返回值

类型:void 无。

备注

要在计算堆大小和调用 CreatePlacedResource 时估算所需纹理的总资源大小,请使用 GetResourceAllocationInfo 而不是 GetResourceTilingGetResourceTiling 不能用于此。 有关平铺资源的详细信息,请参阅 卷平铺资源

要求

头文件: d3d12_xs.h 或 d3d12_x.h
库: d3d12_xs.lib 或 d3d12_x.lib
支持的平台:XBOX Series 主机和 XBOX One 系列

另请参阅

ID3D12Device 子资源
最后修改于 2026年8月24日