ID3D11Device2::GetResourceTiling 方法 (d3d11_2.h)

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

语法

void GetResourceTiling(
  [in]                ID3D11Resource           *pTiledResource,
  [out, optional]     UINT                     *pNumTilesForEntireResource,
  [out, optional]     D3D11_PACKED_MIP_DESC    *pPackedMipDesc,
  [out, optional]     D3D11_TILE_SHAPE         *pStandardTileShapeForNonPackedMips,
  [in, out, optional] UINT                     *pNumSubresourceTilings,
  [in]                UINT                     FirstSubresourceTilingToGet,
  [out]               D3D11_SUBRESOURCE_TILING *pSubresourceTilingsForNonPackedMips
);

参数

[in] pTiledResource

类型: ID3D11Resource*

指向要获取相关信息的平铺资源的指针。

[out, optional] pNumTilesForEntireResource

类型: UINT*

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

[out, optional] pPackedMipDesc

类型: D3D11_PACKED_MIP_DESC*

指向 D3D11_PACKED_MIP_DESC 结构的指针, GetResourceTiling 用有关如何打包平铺资源的 mipmap 的信息填充该结构。

[out, optional] pStandardTileShapeForNonPackedMips

类型: D3D11_TILE_SHAPE*

指向 D3D11_TILE_SHAPE 结构的指针, GetResourceTiling 用有关磁贴形状的信息填充该结构。 这是有关像素如何适应磁贴的信息,与平铺资源的尺寸无关,不包括打包的 mipmap。 如果打包了整个平铺资源,则此参数毫无意义,因为平铺资源对于打包的 mipmap 没有定义的布局。 在这种情况下, GetResourceTilingD3D11_TILE_SHAPE 的成员设置为零。

[in, out, optional] pNumSubresourceTilings

类型: UINT*

指向包含子资源中磁贴数的变量的指针。 输入时,这是要查询其平铺的子资源数;输出时,这是实际在 pSubresourceTilingsForNonPackedMips 中检索的数字, (固定到可用) 。

[in] FirstSubresourceTilingToGet

类型: UINT

要获取的第一个子资源磁贴的编号。 如果 pNumSubresourceTilings 指向的数字为 0,GetResourceTiling 将忽略此参数。

[out] pSubresourceTilingsForNonPackedMips

类型: D3D11_SUBRESOURCE_TILING*

指向 D3D11_SUBRESOURCE_TILING 结构的指针, GetResourceTiling 用有关子资源磁贴的信息填充该结构。

如果子资源磁贴是打包的 mipmap 的一部分, 则 GetResourceTiling 会将 D3D11_SUBRESOURCE_TILING 的成员设置为零,但 StartTileIndexInOverallResource 成员除外, GetResourceTiling 将其设置为 D3D11_PACKED_TILE (0xffffffff) 。 D3D11_PACKED_TILE常量指示整个D3D11_SUBRESOURCE_TILING结构对于这种情况毫无意义,并且 pPackedMipDesc 参数指向的信息适用。

返回值

备注

有关平铺资源的详细信息,请参阅 平铺资源

要求

   
最低受支持的客户端 Windows 8.1 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2012 R2 [桌面应用 |UWP 应用]
目标平台 Windows
标头 d3d11_2.h
Library D3D11.lib

另请参阅

ID3D11Device2