ID3D12Device::GetResourceTiling method (d3d12.h)

Artikel
07/16/2024

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

Sintaksis

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 untuk mendapatkan info.

[out, optional] pNumTilesForEntireResource

Jenis: UINT*

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

[out, optional] pPackedMipDesc

Jenis: D3D12_PACKED_MIP_INFO*

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

[out, optional] pStandardTileShapeForNonPackedMips

Jenis: D3D12_TILE_SHAPE*

Menentukan struktur D3D12_TILE_SHAPE yang GetResourceTiling diisi 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 ubin untuk; pada output, ini adalah angka yang benar-benar diambil di pSubresourceTilingsForNonPackedMips (dijepit ke apa yang tersedia).

[in] FirstSubresourceTilingToGet

Jenis: UINT

Jumlah petak peta sub sumber daya pertama yang akan didapatkan. GetResourceTiling mengabaikan parameter ini jika angka yang pNumSubresourceTilings adalah 0.

[out] pSubresourceTilingsForNonPackedMips

Jenis: D3D12_SUBRESOURCE_TILING*

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

Mengembalikan nilai

Tidak

Komentar

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

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

Persyaratan

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

Lihat juga

ID3D12Device

Sub-sumber daya

Bagikan melalui