struktur D3D12DDI_WORK_GRAPH_DESC_0108 (d3d12umddi.h)

Artikel
05/23/2024

Struktur D3D12DDI_WORK_GRAPH_DESC_0108 mendefinisikan subobjek status jenis D3D12DDI_STATE_SUBOBJECT_TYPE_WORK_GRAPH.

Sintaks

typedef struct D3D12DDI_WORK_GRAPH_DESC_0108 {
  LPCWSTR                             ProgramName;
  UINT                                Version;
  D3D12DDI_WORK_GRAPH_FLAGS_0108      Flags;
  UINT                                NumNodes;
  const D3D12DDI_NODE_LIST_ENTRY_0108 *pNodes;
  UINT                                NumEntrypoints;
  const D3D12DDI_NODE_LIST_ENTRY_0108 *pEntrypoints;
} D3D12DDI_WORK_GRAPH_DESC_0108;

Anggota

ProgramName

Nama grafik kerja. Nama ini unik dalam objek status yang diberikan.

Version

Nomor versi grafik kerja ini, mulai dari 0. Saat PFND3D12DDI_ADD_TO_STATE_OBJECT_0072 digunakan, nilai ini akan bertingkat untuk versi baru.

Jika objek status yang memiliki beberapa penambahan di dalamnya ke bagian lain darinya (mungkin grafik kerja lainnya) mendapatkan grafik kerja yang baru dibuat ditambahkan, Versi akan menjadi 0 untuk penampilan awal grafik kerja baru, meskipun objek status itu sendiri telah memiliki beberapa iterasi. Demikian pula jika penambahan dilakukan ke bagian lain dari objek status tetapi grafik kerja tertentu di dalamnya dibiarkan saja, versinya tidak berubah sampai lain kali penambahan dilakukan pada grafik kerja itu sendiri. Nilai Versi adalah penomoran yang sama yang digunakan di bidang VersiTambahkanD3D12DDI_NODE_0108.

Flags

Enumerasi D3D12DDI_WORK_GRAPH_FLAGS_0108 yang menentukan bendera yang mengontrol perilaku grafik kerja.

NumNodes

Jumlah simpul dalam grafik kerja, termasuk yang sudah ada jika penambahan terjadi. Nilai ini menentukan jumlah elemen dalam array pNodes .

pNodes

Penunjuk ke array struktur D3D12DDI_NODE_LIST_ENTRY_0108 , di mana setiap entri mewakili definisi simpul dalam grafik kerja.

Bahkan dengan bendera D3D12DDI_WORK_GRAPH_FLAG_ADD_TO_EXISTING_WORK_GRAPH , pNodes menunjuk ke daftar semua simpul dalam grafik. Simpul baru muncul di awal daftar.

NumEntrypoints

Jumlah titik masuk termasuk yang sudah ada jika penambahan terjadi. Nilai ini menentukan jumlah elemen dalam array pEntrypoints .

pEntrypoints

Penunjuk ke array struktur D3D12DDI_NODE_LIST_ENTRY_0108 , di mana setiap entri mewakili titik masuk dalam grafik kerja.

Bahkan dengan bendera D3D12DDI_WORK_GRAPH_FLAG_ADD_TO_EXISTING_WORK_GRAPH , pEntryPoints menunjuk ke daftar semua titik masuk. Titik entri baru muncul di awal daftar dan melanjutkan penomoran indeks titik entri setelah versi sebelumnya. Misalnya, misalkan versi awal grafik memiliki dua titik masuk. Daftar ini akan memiliki dua entri, dan driver harus menyimpulkan bahwa mereka memiliki indeks titik masuk [0] dan [1] masing-masing untuk tugas rekaman dari PFND3D12DDI_DISPATCH_GRAPH_0108. Jika penambahan terjadi, dengan 3 titik masuk baru, daftar untuk versi grafik baru akan memiliki 5 entri titik entri, dengan entri baru di awal daftar. Driver harus menyimpulkan indeks titik masuk dari 3 entri baru di awal daftar (entri dengan Versi baru), sehingga daftar lengkapnya adalah [2], [3], [4], [0], [1]. Idealnya tugas-tugas ini akan disediakan oleh runtime di DDI sehingga driver tidak perlu mencari tahu ini, tetapi ini terlewatkan dan dianggap tidak cukup penting untuk diperbaiki.

Keterangan

Struktur D3D12DDI_WORK_GRAPH_DESC_0108 menjelaskan grafik kerja. Grafik kerja itu sendiri adalah kumpulan simpul, di mana setiap simpul mewakili unit kerja atau tugas. Simpul dapat memiliki dependensi satu sama lain, yang menentukan urutan eksekusi. Titik masuk adalah simpul di mana eksekusi dapat dimulai dan biasanya merupakan simpul tanpa dependensi atau yang dapat segera dijalankan.

Runtime memberikan kenyamanan di tingkat API, seperti dapat menentukan grafik kerja hanya dengan mencantumkan titik masuk atau bahkan dengan meminta semua simpul yang tersedia untuk digunakan. Runtime mengambil definisi grafik kerja API, memvalidasinya, dan memberi driver set simpul akhir dalam grafik, yang digambarkan dalam struktur D3D12DDI_WORK_GRAPH_DESC_0108 ini.

Untuk informasi selengkapnya, lihat Grafik kerja.