PFND3D10DDI_SETRENDERTARGETS fungsi panggilan balik (d3d10umddi.h)

Artikel
03/08/2023

SetrenderTargets set fungsi panggilan balik merender permukaan target.

Sintaks

PFND3D10DDI_SETRENDERTARGETS Pfnd3d10ddiSetrendertargets;

void Pfnd3d10ddiSetrendertargets(
  [in] D3D10DDI_HDEVICE unnamedParam1,
  [in] const D3D10DDI_HRENDERTARGETVIEW *unnamedParam2,
  [in] UINT NumViews,
  [in] UINT ClearSlots,
  [in] D3D10DDI_HDEPTHSTENCILVIEW unnamedParam5
)
{...}

Parameter

[in] unnamedParam1

hDevice: Handel ke perangkat tampilan (konteks grafis).

[in] unnamedParam2

phRenderTargetView: Array handel ke objek tampilan target render untuk diatur. Perhatikan bahwa beberapa nilai handel bisa NULL.

[in] NumViews

: Jumlah elemen dalam array yang ditentukan phRenderTargetView .

[in] ClearSlots

Jumlah slot target render setelah jumlah slot yang ditentukan NumViews untuk diatur ke NULL. Angka ini menunjukkan perbedaan antara jumlah objek tampilan target render sebelumnya (yaitu, ketika runtime Microsoft Direct3D yang sebelumnya disebut SetRenderTargets) dan jumlah baru objek tampilan target render.

Perhatikan bahwa angka yang ditentukan ClearTargets hanyalah bantuan pengoptimalan karena driver tampilan mode pengguna dapat menghitung angka ini.

[in] unnamedParam5

hDepthStencilView: Menangani tampilan stensil kedalaman.

Menampilkan nilai

Tidak ada

Keterangan

Driver dapat menggunakan fungsi panggilan balik pfnSetErrorCb untuk mengatur kode kesalahan.

Driver tampilan mode pengguna harus mengatur semua permukaan target render dan buffer stensil kedalaman secara atomik sebagai satu operasi.

Meskipun parameter NumViews menentukan jumlah handel dalam array yang ditentukan parameter phRenderTargetView , beberapa nilai handel dalam array bisa NULL.

Rentang permukaan target render antara jumlah yang ditentukan NumViews dan jumlah maksimum permukaan target render yang diizinkan diperlukan untuk berisi semua nilai NULL atau tidak terikat. Angka yang ditentukan parameter ClearTargets memberi tahu driver tentang berapa banyak titik ikatan yang harus dibersihkan driver untuk operasi atom saat ini.

Jika panggilan sebelumnya ke SetRenderTargets melewati nilai 2 dalam parameter NumViews dan panggilan saat ini ke SetRenderTargets meneruskan nilai 4 di NumViews, panggilan saat ini ke SetRenderTargets juga meneruskan nilai 0 di parameter ClearTargets . Jika panggilan berturut-turut berikutnya ke SetRenderTargets melewati nilai 1 di NumViews, panggilan berturut-turut juga melewati nilai 3 (4 - 1) di ClearTargets.

Ketika nilai target yang jelas diminta selama operasi kueri mode pengguna, nilainya adalah perbedaan antara jumlah maksimum permukaan target render dan nilai target render.

Driver tidak boleh mengalami kesalahan, kecuali untuk D3DDDIERR_DEVICEREMOVED. Oleh karena itu, jika driver melewati kesalahan apa pun, kecuali untuk D3DDDIERR_DEVICEREMOVED, dalam panggilan ke fungsi pfnSetErrorCb , runtime Microsoft Direct3D akan menentukan bahwa kesalahan sangat penting. Bahkan jika perangkat dihapus, driver tidak diperlukan untuk mengembalikan D3DDDIERR_DEVICEREMOVED; namun, jika penghapusan perangkat mengganggu pengoperasian SetRenderTargets (yang biasanya tidak boleh terjadi), driver dapat kembali D3DDDIERR_DEVICEREMOVED.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows Vista dan versi yang lebih baru dari sistem operasi Windows.
Target Platform	Desktop
Header	d3d10umddi.h (termasuk D3d10umddi.h)

Lihat juga

D3D10DDI_DEVICEFUNCS

pfnSetErrorCb

Bagikan melalui