Método ID3D12Device::GetResourceTiling (d3d12.h)

Obtiene información sobre cómo se divide un recurso en mosaicos.

Sintaxis

void GetResourceTiling(
  [in]                ID3D12Resource           *pTiledResource,
  [out, optional]     UINT                     *pNumTilesForEntireResource,
  [out, optional]     D3D12_PACKED_MIP_INFO    *pPackedMipDesc,
  [out, optional]     D3D12_TILE_SHAPE         *pStandardTileShapeForNonPackedMips,
  [in, out, optional] UINT                     *pNumSubresourceTilings,
  [in]                UINT                     FirstSubresourceTilingToGet,
  [out]               D3D12_SUBRESOURCE_TILING *pSubresourceTilingsForNonPackedMips
);

Parámetros

[in] pTiledResource

Tipo: * ID3D12Resource

Especifica un id3D12Resource en mosaico para obtener información.

[out, optional] pNumTilesForEntireResource

Tipo: UINT*

Puntero a una variable que recibe el número de iconos necesarios para almacenar todo el recurso en mosaico.

[out, optional] pPackedMipDesc

Tipo: D3D12_PACKED_MIP_INFO*

Puntero a una estructura de D3D12_PACKED_MIP_INFO que GetResourceTiling rellena con información sobre cómo se empaquetan los mapas mip del recurso en mosaico.

[out, optional] pStandardTileShapeForNonPackedMips

Tipo: D3D12_TILE_SHAPE*

Especifica una estructura de D3D12_TILE_SHAPE que GetResourceTiling rellena con información sobre la forma de mosaico. Se trata de información sobre cómo encajan los píxeles en los iconos, independientemente de las dimensiones del recurso en mosaico, no incluidos los mapas mip empaquetados. Si se empaqueta todo el recurso en mosaico, este parámetro no tiene sentido porque el recurso en mosaico no tiene ningún diseño definido para los mapas mip empaquetados. En esta situación, GetResourceTiling establece los miembros de D3D12_TILE_SHAPE en ceros.

[in, out, optional] pNumSubresourceTilings

Tipo: UINT*

Puntero a una variable que contiene el número de iconos del subrecurso. En la entrada, este es el número de subrecursos para los que se consultan los mosaicos; en la salida, este es el número que se recuperó realmente en pSubresourceTilingsForNonPackedMips (abrazado a lo que está disponible).

[in] FirstSubresourceTilingToGet

Tipo: UINT

Número del primer icono de subrecurso que se va a obtener. GetResourceTiling omite este parámetro si el número que pNumSubresourceTilings apunta a es 0.

[out] pSubresourceTilingsForNonPackedMips

Tipo: D3D12_SUBRESOURCE_TILING*

Especifica una estructura D3D12_SUBRESOURCE_TILING que GetResourceTiling rellena con información sobre los iconos de subrecursos. Si los iconos de subrecursos forman parte de mapas mip empaquetados, GetResourceTiling establece los miembros de D3D12_SUBRESOURCE_TILING en ceros, excepto el miembro StartTileIndexInOverallResource, que GetResourceTiling establece en D3D12_PACKED_TILE (0xffffffff). La constante D3D12_PACKED_TILE indica que toda la estructura D3D12_SUBRESOURCE_TILING no tiene sentido para esta situación y la información a la que apunta el parámetro pPackedMipDesc se aplica.

Valor devuelto

Ninguno

Observaciones

Para calcular el tamaño total de recursos de las texturas necesarias al calcular los tamaños del montón y llamar a CreatePlacedResource, use GetResourceAllocationInfo en lugar de GetResourceTiling. GetResourceTiling no se puede usar para esto.

Para obtener más información sobre los recursos en mosaico, consulte Recursos en mosaico de volumen.

Requisitos

Requisito	Valor
de la plataforma de destino de	Windows
encabezado de	d3d12.h
biblioteca de	D3d12.lib
DLL de	D3d12.dll

Consulte también

ID3D12Device

subrecursos