Bagikan melalui

METODE ID3D12DebugCommandList1::AssertResourceState (d3d12sdklayers.h)

  • Artikel

Memvalidasi bahwa status yang diberikan cocok dengan status subresource, dengan asumsi status sub sumber daya yang diberikan diketahui selama perekaman daftar perintah (misalnya sumber daya ditransisikan sebelumnya dalam rekaman daftar perintah yang sama). Jika status belum diketahui, metode ini menetapkan status yang diketahui untuk validasi lebih lanjut nanti dalam perekaman daftar perintah yang sama.

Sintaks

BOOL AssertResourceState(
  [in] ID3D12Resource *pResource,
       UINT           Subresource,
       UINT           State
);

Parameter

[in] pResource

Jenis: ID3D12Resource*

Menentukan ID3D12Resource untuk diperiksa.

Subresource

Jenis: UINT

Indeks subsumber daya untuk diperiksa. Ini dapat diatur ke indeks, atau D3D12_RESOURCE_BARRIER_ALL_SUBRESOURCES.

State

Jenis: UINT

Menentukan status yang akan diperiksa. Ini bisa menjadi satu atau beberapa bendera D3D12_RESOURCE_STATES Atau digabungkan.

Mengembalikan nilai

Jenis: BOOL

Metode ini mengembalikan true jika status sumber daya atau sub sumber daya yang dilacak cocok dengan status yang ditentukan, salah jika tidak.

Keterangan

Karena eksekusi daftar perintah terjadi beberapa saat setelah perekaman, status sumber daya sering kali tidak dapat diketahui selama perekaman daftar perintah. AssertResourceState memberi pengembang aplikasi kemampuan untuk memberlakukan status yang diasumsikan pada sumber daya atau subsumber daya pada titik perekaman tetap dalam daftar perintah.

Seringkali status sumber daya atau subsumber daya dapat diketahui karena hambatan sebelumnya atau penggunaan yang disimpulkan (misalnya, digunakan dalam panggilan sebelumnya ke CopyBufferRegion) selama perekaman daftar perintah. Dalam kasus seperti itu AssertResourceState dapat menghasilkan pesan debug jika status yang diberikan tidak cocok dengan status yang diketahui atau diasumsikan.

API ini hanya untuk validasi debug dan tidak memengaruhi runtime aktual atau status GPU sumber daya.

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header d3d12sdklayers.h

Lihat juga

ID3D12DebugCommandList1