struktur D3D12DDI_COALESCING_LAUNCH_NODE_PROPERTIES_0108 (d3d12umddi.h)

Artikel
07/16/2024

Struktur D3D12DDI_COALESCING_LAUNCH_NODE_PROPERTIES_0108 menjelaskan properti node peluncuran coalescing dalam grafik kerja.

Sintaksis

typedef struct D3D12DDI_COALESCING_LAUNCH_NODE_PROPERTIES_0108 {
  D3D12DDI_NODE_ID_0108               FinalName;
  BOOL                                bProgramEntry;
  D3D12DDI_NODE_IO_KIND_0108          InputNodeIOKind;
  UINT                                InputNodeIOFlags;
  UINT                                InputRecordSizeInBytes;
  UINT                                InputMaxRecordArraySize;
  UINT                                GroupSharedUsageInBytes;
  UINT                                MaxRecursionDepth;
  const UINT                          *pLocalRootArgumentsTableIndex;
  const D3D12DDI_NODE_0108            *pShareInputOfNode;
  const D3D12DDI_NODE_LIST_ENTRY_0108 *pInputNodes;
  const D3D12DDI_NODE_LIST_ENTRY_0108 *pNodesSharingInputWithThisNode;
  UINT                                NumOutputs;
  const D3D12DDI_NODE_OUTPUT_0108     *pOutputs;
} D3D12DDI_COALESCING_LAUNCH_NODE_PROPERTIES_0108;

Anggota

FinalName

Struktur D3D12DDI_NODE_ID_0108 yang menentukan nama akhir simpul setelah penggantian nama opsional dilakukan di tingkat aplikasi.

bProgramEntry

Ketika TRUE, simpul saat ini adalah entri program dan tercantum dalam daftar pEntrypoints di D3D12DDI_WORK_GRAPH_DESC_0108. Dengan demikian, parameter ini berlebihan, tetapi ada untuk kejelasan. Shader mungkin belum menyatakan bahwa simpul adalah titik masuk tetapi runtime mungkin telah menentukannya harus satu, atau di API pilihan mungkin telah ditimpa dalam beberapa cara. Anggota ini selalu TRUE untuk simpul yang tidak ditargetkan oleh simpul lain dalam grafik.

InputNodeIOKind

Enumerasi D3D12DDI_NODE_IO_KIND_0108 yang menentukan kelas input. Lihatdeklarasi input simpul .

InputNodeIOFlags

Bendera yang memberikan informasi tambahan tentang I/O input node. Lihat bendera dalam D3D12DDI_NODE_IO_FLAGS_FLAG_MASK di D3D12DDI_NODE_IO_FLAGS_0108. Untuk input, satu-satunya bendera yang berlaku adalah D3D12DDI_NODE_IO_FLAG_TRACK_RW_INPUT_SHARING.

InputRecordSizeInBytes

Ukuran rekaman input, dalam byte. Bisa 0 jika InputNodeIOKind D3D12DDI_NODE_IO_KIND_EMPTY_INPUT_0108.

InputMaxRecordArraySize

Jumlah maksimum rekaman input yang dinyatakan shader yang dapat dimasukkan ke peluncuran grup utas untuk simpul peluncuran coalescing ini.

GroupSharedUsageInBytes

Ukuran penggunaan bersama grup oleh simpul, dalam byte.

MaxRecursionDepth

Rekursi maks dideklarasikan oleh shader. Nilai 0 berarti tidak ada rekursi.

pLocalRootArgumentsTableIndex

Jika tanda tangan akar lokal telah dikaitkan dengan shader dan/atau shader secara eksplisit mendeklarasikan indeks tabel argumen akar lokal yang ingin digunakannya, indeks berbasis 0 ditujukkan ke sini. Runtime mungkin telah menetapkan lokasi secara otomatis. Jika tidak ada tanda tangan akar lokal yang dikaitkan dengan shader, ini akan nullptr.

pShareInputOfNode

Penunjuk opsional ke simpul yang berbagi input yang sama dengan simpul ini, atau nullptr jika simpul saat ini tidak berbagi input simpul lain. Jika simpul ini berbagi inputnya dari simpul lain dalam grafik kerja, pShareInputOfNode menunjuk ke simpul tersebut, yang diwakili oleh struktur D3D12DDI_NODE_0108. Jika beberapa simpul berada dalam set berbagi input, semua kecuali simpul sumber menunjuk ke simpul sumber, dan simpul sumber sebagai gantinya mengatur parameter pNodesSharingInputWithThisNode untuk menunjuk ke yang lain.

pInputNodes

Pointer ke daftar (D3D12DDI_NODE_LIST_ENTRY_0108) simpul ((D3D12DDI_NODE_0108) yang menargetkan simpul saat ini. pInputNodesnullptr jika tidak ada simpul yang menargetkan simpul ini.

pNodesSharingInputWithThisNode

Pointer ke daftar (D3D12DDI_NODE_LIST_ENTRY_0108) simpul ((D3D12DDI_NODE_0108) yang berbagi input dengan simpul saat ini. pNodesSharingInputWithThisNodenullptr jika tidak ada simpul yang berbagi input dengan simpul ini.

NumOutputs

Jumlah simpul yang dihasilkan simpul ini.

pOutputs

Penunjuk ke array NumOutputsD3D12DDI_NODE_OUTPUT_0108 struktur yang berisi definisi output. pOutputsnullptr jika simpul ini tidak menghasilkan ke simpul lain.

Komentar

Setiap properti yang tercantum di sini lebih diutamakan daripada (mengambil alih) apa yang mungkin telah dideklarasikan dalam shader untuk simpul. Driver harus selalu menggunakan properti yang tercantum di sini sebagai pilihan properti akhir. Jika pengemudi kebetulan peduli tentang apakah sesuatu ditimpa, itu dapat membandingkan pengaturan apa pun di sini terhadap apa yang dinyatakan shader.

Untuk informasi selengkapnya, lihat grafik Work.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows 11, versi 24H2 (WDDM 3.2)
Header	d3d12umddi.h

Lihat juga

D3D12DDI_SHADER_NODE_0108

Bagikan melalui