Metode ID3D12GraphicsCommandList1::SetViewInstanceMask (d3d12.h)

Atur masker yang mengontrol instans tampilan mana yang diaktifkan untuk gambar berikutnya.

Sintaks

void SetViewInstanceMask(
  [in] UINT Mask
);

Parameter

[in] Mask

Jenis: UINT

Masker yang menentukan tampilan mana yang diaktifkan atau dinonaktifkan. Jika bit i mulai dari bit yang paling tidak signifikan diatur, lihat instans i diaktifkan.

Nilai kembali

Tidak ada

Keterangan

Masker instans tampilan hanya memengaruhi PSO yang mendeklarasikan masking instans tampilan dengan menentukan bendera D3D12_VIEW_INSTANCING_FLAG_ENABLE_VIEW_INSTANCE_MASKING selama pembuatannya. Mencoba membuat PSO yang menyatakan masking instans tampilan akan gagal pada adaptor yang tidak mendukung instansi tampilan.

Tampilan instans mask default ke 0 yang menonaktifkan semua tampilan. Ini memaksa aplikasi yang mendeklarasikan masking instans tampilan untuk secara eksplisit memilih tampilan untuk diaktifkan, jika tidak, tidak ada yang akan dirender. Jika masker instans tampilan diaktifkan semua tampilan secara default, aplikasi mungkin tidak ingat untuk menonaktifkan tampilan yang tidak digunakan, yang mengakibatkan hilangnya performa karena pekerjaan yang terbuang sia-sia.

Bundel tidak mewarisi masker instans tampilan mereka dari pemanggilnya, default ke 0 sebagai gantinya. Ini karena pengaturan masker harus diketahui ketika bundel direkam jika memengaruhi bagaimana rekaman implementasi menarik. Namun, masker instans tampilan yang diatur oleh bundel tetap ada di pemanggil setelah bundel selesai. Semantik warisan ini mirip dengan PSO.

Tidak ada jalur kode shader yang bergantung pada SV_ViewID dijalankan pada tahap shader apa pun untuk melihat instans yang ditutupi dan tidak ada kliping, pemrosesan viewport, atau rasterisasi dilakukan. Implementasi yang memeriksa masker selama penyajian dapat dikenakan hukuman performa kecil atas PSO yang tidak mendeklarasikan tampilan masking instans sama sekali, tetapi biasanya penalti dapat diatasi oleh penghematan performa yang dihasilkan dari melewatkan pekerjaan yang terkait dengan tampilan tertutup. Tergantung pada frekuensi dan jumlah pekerjaan yang dilewati, perolehan performa bisa signifikan.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	d3d12.h

Lihat juga

ID3D12GraphicsCommandList1