METODE ID3D12GraphicsCommandList::D iscardResource (d3d12.h)

Menunjukkan bahwa konten sumber daya tidak perlu dipertahankan. Fungsi ini dapat menginisialisasi ulang metadata sumber daya dalam beberapa kasus.

Sintaks

void DiscardResource(
  ID3D12Resource             *pResource,
  const D3D12_DISCARD_REGION *pRegion
);

pResource

Penunjuk ke antarmuka ID3D12Resource agar sumber daya dapat dibuang.

pRegion

Jenis: [in, opsional] const D3D12_DISCARD_REGION*

Penunjuk ke struktur D3D12_DISCARD_REGION yang menjelaskan detail untuk operasi buang-sumber daya.

Tidak ada

Semantik perubahan DiscardResource berdasarkan jenis daftar perintah.

Untuk D3D12_COMMAND_LIST_TYPE_DIRECT, dua aturan berikut berlaku:

Ketika sumber daya memiliki bendera D3D12_RESOURCE_FLAG_ALLOW_RENDER_TARGET , DiscardResource harus dipanggil ketika wilayah sub sumber daya yang dibuang berada dalam status hambatan sumber daya D3D12_RESOURCE_STATE_RENDER_TARGET .
Ketika sumber daya memiliki bendera D3D12_RESOURCE_FLAG _ALLOW_DEPTH_STENCIL , DiscardResource harus dipanggil ketika wilayah subresource yang dibuang berada di D3D12_RESOURCE_STATE_DEPTH_WRITE.

Untuk D3D12_COMMAND_LIST_TYPE_COMPUTE, aturan berikut berlaku:

Sumber daya harus memiliki bendera D3D12_RESOURCE_FLAG_ALLOW_UNORDERED_ACCESS , dan DiscardResource harus dipanggil ketika wilayah sub sumber daya yang dibuang berada dalam status penghalang sumber daya D3D12_RESOURCE_STATE_UNORDERED_ACCESS .

DiscardResource tidak didukung pada daftar perintah dengan D3D12_COMMAND_LIST_TYPE_BUNDLE atau D3D12_COMMAND_LIST_TYPE_COPY.