> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GetResourceTiling

> 获取有关平铺资源如何分解为平铺的信息。(ID3D12Device.GetResourceTiling)

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

## 语法

```cpp theme={null}
void GetResourceTiling(
    ID3D12Resource  pTiledResource,
    UINT  pNumTilesForEntireResource,
    D3D12_PACKED_MIP_INFO  pPackedMipDesc,
    D3D12_TILE_SHAPE  pStandardTileShapeForNonPackedMips,
    UINT  pNumSubresourceTilings,
    UINT FirstSubresourceTilingToGet,
    D3D12_SUBRESOURCE_TILING  pSubresourceTilingsForNonPackedMips
)
```

### 参数

*pTiledResource \[in]*\
类型：ID3D12Resource \*

指定要获取信息的平铺 [ID3D12Resource](https://docs.xbox.com/zh-CN/reference/graphics/d3d12_xs/interfaces/ID3D12Resource/id3d12resource_xs.md)。

*pNumTilesForEntireResource \[out, optional]*\
类型：UINT \*

指向变量的指针，该变量接收存储整个平铺资源所需的平铺数。

*pPackedMipDesc \[out, optional]*\
类型：D3D12\_PACKED\_MIP\_INFO \*

指向 [D3D12\_PACKED\_MIP\_INFO](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/structs/d3d12_packed_mip_info_public.md) 结构体的指针，**GetResourceTiling** 使用有关平铺资源的 mipmap 如何打包的信息填充该结构体。

*pStandardTileShapeForNonPackedMips \[out, optional]*\
类型：D3D12\_TILE\_SHAPE \*

指定 [D3D12\_TILE\_SHAPE](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/structs/d3d12_tile_shape_public.md) 结构体，**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](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/structs/d3d12_subresource_tiling_public.md) 结构体，**GetResourceTiling** 使用有关子资源平铺的信息填充该结构体。如果子资源平铺是打包 mipmap 的一部分，则 **GetResourceTiling** 将 D3D12\_SUBRESOURCE\_TILING 的成员设置为零，但 *StartTileIndexInOverallResource* 成员除外，**GetResourceTiling** 将该成员设置为 D3D12\_PACKED\_TILE (0xffffffff)。D3D12\_PACKED\_TILE 常量表示整个 **D3D12\_SUBRESOURCE\_TILING** 结构体在此情况下无意义，并且 *pPackedMipDesc* 参数指向的信息适用。

### 返回值

类型：void

无。

## 备注

要在计算堆大小和调用 [CreatePlacedResource](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_createplacedresource_public.md) 时估算所需纹理的总资源大小，请使用 [GetResourceAllocationInfo](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_getresourceallocationinfo_public.md) 而不是 **GetResourceTiling**。
**GetResourceTiling** 不能用于此。

有关平铺资源的详细信息，请参阅 [卷平铺资源](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/volume-tiled-resources)。

## 要求

**头文件：** d3d12\_xs.h 或 d3d12\_x.h\
**库：** d3d12\_xs.lib 或 d3d12\_x.lib\
**支持的平台**：XBOX Series 主机和 XBOX One 系列

## 另请参阅

[ID3D12Device](https://docs.xbox.com/zh-CN/reference/graphics/d3d12_x/interfaces/id3d12device/id3d12device.md)

[子资源](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/subresources)


## Related topics

- [D3D12_SUBRESOURCE_TILING](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/structs/d3d12_subresource_tiling_public.md)
- [D3D12_TILE_SHAPE](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/structs/d3d12_tile_shape_public.md)
- [GetResourceAllocationInfo](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_getresourceallocationinfo_public.md)
- [GetResourceAllocationInfo1 (XBOX Series 主机)](https://docs.xbox.com/zh-CN/reference/graphics/d3d12/interfaces/id3d12device4/methods/id3d12device4_getresourceallocationinfo1_public.md)
- [NDA 主题目录 - Microsoft Learn 在线链接](https://docs.xbox.com/zh-CN/nda/nda-topic-directory.md)