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

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

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 sobre el que 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 del icono. 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 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 (sujeta 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 al que apunta pNumSubresourceTilings es 0.

[out] pSubresourceTilingsForNonPackedMips

Tipo: D3D12_SUBRESOURCE_TILING*

Especifica una estructura de D3D12_SUBRESOURCE_TILING que GetResourceTiling rellena con información sobre los iconos de subrecursos. Si los iconos de subrecurso 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 de 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

Plataforma de destino	Windows
Encabezado	d3d12.h
Library	D3d12.lib
Archivo DLL	D3d12.dll

Consulte también

ID3D12Device

Subrecursos