ID3D12Device5::GetRaytracingAccelerationStructurePrebuildInfo metode (d3d12.h)

Artikel
08/23/2023

Kueri driver untuk persyaratan sumber daya untuk membangun struktur akselerasi.

Sintaks

void GetRaytracingAccelerationStructurePrebuildInfo(
  [in]  const D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_INPUTS *pDesc,
  [out] D3D12_RAYTRACING_ACCELERATION_STRUCTURE_PREBUILD_INFO      *pInfo
);

Parameter

[in] pDesc

Deskripsi build struktur akselerasi. Struktur ini dibagikan dengan BuildRaytracingAccelerationStructure. Untuk informasi selengkapnya, lihat D3D12_BUILD_RAYTRACING_ACCELERATION_STRUCTURE_INPUTS.

Implementasi diizinkan untuk melihat semua parameter CPU dalam struktur ini dan struktur berlapis. Ini mungkin tidak memeriksa/mendereferensikan alamat virtual GPU apa pun, selain memeriksa untuk melihat apakah pointer adalah NULL atau tidak, seperti transformasi opsional dalam D3D12_RAYTRACING_GEOMETRY_TRIANGLES_DESC, tanpa mendereferensikannya. Dengan kata lain, perhitungan persyaratan sumber daya untuk struktur akselerasi tidak bergantung pada data geometri aktual (seperti posisi puncak), melainkan hanya dapat bergantung pada properti keseluruhan, seperti jumlah segitiga, jumlah instans dll.

[out] pInfo

Hasil kueri.

Nilai kembali

Tidak ada

Keterangan

Deskripsi struktur akselerasi input sama dengan apa yang masuk ke BuildRaytracingAccelerationStructure. Hasil dari fungsi ini memungkinkan aplikasi menyediakan jumlah penyimpanan output dan penyimpanan awal yang benar untuk BuildRaytracingAccelerationStructure dengan geometri yang sama.

Build juga dapat dilakukan dengan konfigurasi yang sama yang diteruskan ke GetAccelerationStructurePrebuildInfo secara keseluruhan kecuali jumlah yang sama atau lebih kecil untuk jumlah geometri/instans atau jumlah simpul/indeks/AABB dalam geometri tertentu. Dalam hal ini persyaratan penyimpanan yang dilaporkan dengan ukuran asli yang diteruskan ke GetRaytracingAccelerationStructurePrebuildInfo akan valid - build mungkin benar-benar mengonsumsi lebih sedikit ruang tetapi tidak lebih. Ini berguna untuk skenario aplikasi di mana memiliki penyimpanan konservatif besar yang dialokasikan untuk struktur akselerasi baik-baik saja.

Metode ini ada pada antarmuka perangkat dibandingkan dengan daftar perintah pada asumsi bahwa driver harus dapat menghitung persyaratan sumber daya untuk build struktur akselerasi dari hanya melihat bagian panggilan yang terlihat CPU, tanpa harus mendereferensikan pointer apa pun ke memori GPU yang berisi data puncak aktual, data indeks, dll.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10, versi 1809 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2016 [hanya aplikasi desktop]
Target Platform	Windows
Header	d3d12.h
Pustaka	D3d12.lib
DLL	D3d12.dll

Lihat juga

ID3D12Device5

Bagikan melalui