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 结构的指针, GetResourceTiling 用有关如何打包平铺资源的 mipmap 的信息填充该结构。
[out, optional] pStandardTileShapeForNonPackedMips
类型: D3D11_TILE_SHAPE*
指向 D3D11_TILE_SHAPE 结构的指针, GetResourceTiling 用有关磁贴形状的信息填充该结构。 这是有关像素如何适应磁贴的信息,与平铺资源的尺寸无关,不包括打包的 mipmap。 如果打包了整个平铺资源,则此参数毫无意义,因为平铺资源对于打包的 mipmap 没有定义的布局。 在这种情况下, GetResourceTiling 将 D3D11_TILE_SHAPE 的成员设置为零。
[in, out, optional] pNumSubresourceTilings
类型: UINT*
指向包含子资源中磁贴数的变量的指针。 输入时,这是要查询其平铺的子资源数;输出时,这是实际在 pSubresourceTilingsForNonPackedMips 中检索的数字, (固定到可用) 。
[in] FirstSubresourceTilingToGet
类型: UINT
要获取的第一个子资源磁贴的编号。 如果 pNumSubresourceTilings 指向的数字为 0,GetResourceTiling 将忽略此参数。
[out] pSubresourceTilingsForNonPackedMips
指向 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 |