METODE ID3D12GraphicsCommandList4::CopyRaytracingAccelerationStructure (d3d12.h)

Artikel
02/29/2024

Menyalin struktur akselerasi sumber ke memori tujuan saat menerapkan transformasi yang ditentukan.

Sintaks

void CopyRaytracingAccelerationStructure(
  [in] D3D12_GPU_VIRTUAL_ADDRESS                         DestAccelerationStructureData,
  [in] D3D12_GPU_VIRTUAL_ADDRESS                         SourceAccelerationStructureData,
  [in] D3D12_RAYTRACING_ACCELERATION_STRUCTURE_COPY_MODE Mode
);

Parameter

[in] DestAccelerationStructureData

Memori tujuan. Ukuran yang diperlukan dapat ditemukan dengan memanggil EmitRaytracingAccelerationStructurePostbuildInfo sebelumnya, jika perlu untuk Mode yang ditentukan.

Alamat mulai tujuan harus diselaraskan ke 256 byte, yang didefinisikan sebagai D3D12_RAYTRACING_ACCELERATION_STRUCTURE_BYTE_ALIGNMENT, terlepas dari Mode yang ditentukan.

Rentang memori tujuan tidak dapat tumpang tindih dengan sumber. Jika tidak, hasilnya tidak ditentukan.

Status sumber daya yang ditujukan memori harus berada tergantung pada parameter Mode . Untuk informasi selengkapnya, lihat D3D12_RAYTRACING_ACCELERATION_STRUCTURE_COPY_MODE.

[in] SourceAccelerationStructureData

Alamat struktur akselerasi atau jenis data lain untuk disalin/diubah berdasarkan Mode yang ditentukan. Data tetap tidak berubah dan dapat digunakan. Operasi hanya menyalin data yang ditujukan oleh SourceAccelerationStructureData dan bukan data lain, seperti struktur akselerasi, yang mungkin ditujukan oleh data sumber. Misalnya, dalam kasus struktur akselerasi tingkat atas, struktur akselerasi tingkat bawah apa pun yang ditujukannya tidak disalin dalam operasi.

Memori sumber harus diselaraskan ke 256 byte, didefinisikan sebagai D3D12_RAYTRACING_ACCELERATION_STRUCTURE_BYTE_ALIGNMENT, terlepas dari Mode yang ditentukan.

Status sumber daya yang ditujukan memori harus berada tergantung pada parameter Mode . Untuk informasi selengkapnya, lihat D3D12_RAYTRACING_ACCELERATION_STRUCTURE_COPY_MODE.

[in] Mode

Jenis operasi salin yang akan dilakukan. Untuk informasi selengkapnya, lihat D3D12_RAYTRACING_ACCELERATION_STRUCTURE_COPY_MODE.

Nilai kembali

Tidak ada

Keterangan

Karena struktur akselerasi raytracing mungkin berisi pointer internal dan memiliki tata letak buram yang bergantung pada perangkat, menyalinnya di sekitar atau memanipulasinya memerlukan API khusus sehingga driver dapat menangani operasi yang diminta.

Metode ini dapat dipanggil dari grafik atau daftar perintah komputasi tetapi tidak dari bundel.

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

ID3D12GraphicsCommandList4

Bagikan melalui