ID3D12Device::GetResourceTiling method (d3d12.h)

Mendapatkan info tentang bagaimana sumber daya ubin dipecah menjadi petak peta.

Sintaks

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
);

Parameter

[in] pTiledResource

Jenis: ID3D12Resource*

Menentukan ID3D12Resource berjenjang untuk mendapatkan info tentang.

[out, optional] pNumTilesForEntireResource

Jenis: UINT*

Penunjuk ke variabel yang menerima jumlah petak peta yang diperlukan untuk menyimpan seluruh sumber daya ubin.

[out, optional] pPackedMipDesc

Jenis: D3D12_PACKED_MIP_INFO*

Penunjuk ke struktur D3D12_PACKED_MIP_INFO yang diisi GetResourceTiling dengan info tentang bagaimana mipmap sumber daya ubin dikemas.

[out, optional] pStandardTileShapeForNonPackedMips

Jenis: D3D12_TILE_SHAPE*

Menentukan struktur D3D12_TILE_SHAPE yang diisi GetResourceTiling dengan info tentang bentuk petak peta. Ini adalah info tentang bagaimana piksel pas dalam petak peta, terlepas dari dimensi sumber daya ubin, tidak termasuk mipmap yang dikemas. Jika seluruh sumber daya ubin dikemas, parameter ini tidak berarti karena sumber daya ubin tidak memiliki tata letak yang ditentukan untuk mipmap yang dikemas. Dalam situasi ini, GetResourceTiling menetapkan anggota D3D12_TILE_SHAPE ke nol.

[in, out, optional] pNumSubresourceTilings

Jenis: UINT*

Penunjuk ke variabel yang berisi jumlah petak peta di sub sumber daya. Pada input, ini adalah jumlah sub sumber daya untuk mengkueri petak peta untuk; pada output, ini adalah angka yang benar-benar diambil di pSubresourceTilingsForNonPackedMips (dijepit dengan apa yang tersedia).

[in] FirstSubresourceTilingToGet

Jenis: UINT

Jumlah petak peta subresource pertama yang akan didapatkan. GetResourceTiling mengabaikan parameter ini jika angka yang dirujuk pNumSubresourceTilings adalah 0.

[out] pSubresourceTilingsForNonPackedMips

Jenis: D3D12_SUBRESOURCE_TILING*

Menentukan struktur D3D12_SUBRESOURCE_TILING yang diisi GetResourceTiling dengan info tentang petak peta sub sumber daya. Jika petak peta sub sumber daya adalah bagian dari mipmap yang dikemas, GetResourceTiling mengatur anggota D3D12_SUBRESOURCE_TILING ke nol, kecuali anggota StartTileIndexInOverallResource , yang ditetapkan GetResourceTiling ke D3D12_PACKED_TILE (0xffffffff). Konstanta D3D12_PACKED_TILE menunjukkan bahwa seluruh struktur D3D12_SUBRESOURCE_TILING tidak ada artinya untuk situasi ini, dan info yang ditunjukkan parameter pPackedMipDesc untuk diterapkan.

Menampilkan nilai

Tidak ada

Keterangan

Untuk memperkirakan ukuran total sumber daya tekstur yang diperlukan saat menghitung ukuran heap dan memanggil CreatePlacedResource, gunakan GetResourceAllocationInfoalih-alih GetResourceTiling. GetResourceTiling tidak dapat digunakan untuk ini.

Untuk informasi selengkapnya tentang sumber daya berjenjang, lihat Sumber Daya Ubin Volume.

Persyaratan

Target Platform	Windows
Header	d3d12.h
Pustaka	D3d12.lib
DLL	D3d12.dll

Lihat juga

ID3D12Device

Subresources