METODE ID3D12GraphicsCommandList::ClearUnorderedAccessViewUint (d3d12.h)
Mengatur semua elemen dalam tampilan akses tidak berurut (UAV) ke nilai bilangan bulat yang ditentukan.
Sintaks
void ClearUnorderedAccessViewUint(
D3D12_GPU_DESCRIPTOR_HANDLE ViewGPUHandleInCurrentHeap,
D3D12_CPU_DESCRIPTOR_HANDLE ViewCPUHandle,
ID3D12Resource *pResource,
const UINT [4] Values,
UINT NumRects,
const D3D12_RECT *pRects
);
Parameter
ViewGPUHandleInCurrentHeap
Jenis: [in] D3D12_GPU_DESCRIPTOR_HANDLE
D3D12_GPU_DESCRIPTOR_HANDLE yang mereferensikan deskriptor yang diinisialisasi untuk tampilan akses tidak berurut (UAV) yang akan dibersihkan. Deskriptor ini harus berada dalam tumpukan deskriptor yang terlihat shader, yang harus diatur pada daftar perintah melalui SetDescriptorHeaps.
ViewCPUHandle
Jenis: [in] D3D12_CPU_DESCRIPTOR_HANDLE
D3D12_CPU_DESCRIPTOR_HANDLE dalam tumpukan deskriptor yang terlihat non-shader yang mereferensikan deskriptor yang diinisialisasi untuk tampilan akses tidak berurutan (UAV) yang akan dihapus.
Penting
Deskriptor ini tidak boleh berada dalam tumpukan deskriptor yang terlihat shader. Ini untuk memungkinkan driver yang mengimplementasikan yang jelas sebagai operasi perangkat keras fungsi tetap (bukan sebagai pengiriman) untuk membaca secara efisien dari deskriptor, karena tumpukan yang terlihat shader dapat dibuat dalam memori WRITE_BACK (mirip dengan jenis tumpukan D3D12_HEAP_TYPE_UPLOAD ), dan pembacaan CPU dari jenis memori ini dilarang lambat.
pResource
Jenis: [in] ID3D12Resource*
Penunjuk ke antarmuka ID3D12Resource yang mewakili sumber daya unordered-access-view (UAV) untuk dihapus.
Values
Jenis: [in] const UINT[4]
Array 4 komponen yang berisi nilai untuk mengisi sumber daya tampilan akses yang tidak diurutkan.
NumRects
Jenis: [in] UINT
Jumlah persegi panjang dalam array yang ditentukan parameter pRects .
pRects
Jenis: [in] const D3D12_RECT*
Array struktur D3D12_RECT untuk persegi panjang dalam tampilan sumber daya untuk dihapus. Jika NULL, ClearUnorderedAccessViewUint menghapus seluruh tampilan sumber daya.
Nilai kembali
Tidak ada
Keterangan
Validasi runtime
Kegagalan validasi menghasilkan panggilan ke ID3D12GraphicsCommandList::Close mengembalikan E_INVALIDARG.
Lapisan debug
Lapisan debug mengeluarkan kesalahan jika nilai input berada di luar rentang yang dinormalisasi.
Lapisan debug mengeluarkan kesalahan jika subsumber daya yang direferensikan oleh tampilan tidak dalam status yang sesuai. Untuk ClearUnorderedAccessViewUint, status harus D3D12_RESOURCE_STATE_UNORDERED_ACCESS.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Windows |
Header | d3d12.h |
Pustaka | D3d12.lib |
DLL | D3d12.dll |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk