PFND3D10DDI_SO_SETTARGETS fungsi panggilan balik (d3d10umddi.h)

Artikel
02/22/2024

Fungsi SoSetTargets menetapkan sumber daya target output aliran.

Sintaks

PFND3D10DDI_SO_SETTARGETS Pfnd3d10ddiSoSettargets;

void Pfnd3d10ddiSoSettargets(
       D3D10DDI_HDEVICE unnamedParam1,
  [in] UINT NumBuffers,
  [in] UINT ClearTargets,
       const D3D10DDI_HRESOURCE *unnamedParam4,
       const UINT *unnamedParam5
)
{...}

Parameter

unnamedParam1

hDevice [in]

Handel ke perangkat tampilan (konteks grafis).

[in] NumBuffers

Jumlah elemen dalam array yang ditentukan phResource .

[in] ClearTargets

Jumlah handel untuk mengalirkan sumber daya target output yang mewakili perbedaan antara jumlah sumber daya target output aliran sebelumnya (sebelum runtime Microsoft Direct3D memanggil SoSetTargets) dan jumlah sumber daya target output aliran baru.

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

unnamedParam4

phResource [in]

Array handel ke sumber daya target output aliran untuk diatur. Perhatikan bahwa beberapa nilai handel bisa NULL.

unnamedParam5

pOffsets [in]

Array offset, dalam byte, ke dalam sumber daya target output aliran dalam array yang ditentukan phResource .

Menampilkan nilai

Tidak ada

Keterangan

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

Rentang sumber daya target output aliran antara angka yang ditentukan parameter SOTargets dan jumlah maksimum sumber daya target output aliran 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 saat ini. Jika panggilan sebelumnya ke SoSetTargets meneruskan nilai 2 di SOTargetsdan panggilan saat ini ke SoSetTargets meneruskan nilai 4 di SOTargets, panggilan saat ini ke SoSetTargets juga meneruskan nilai 0 dalam parameter ClearTargets . Jika panggilan berturut-turut berikutnya ke SoSetTargets melewati nilai 1 di SOTargets, panggilan berturut-turut juga melewati nilai 3 (4 - 1) di ClearTargets.

Driver seharusnya tidak mengalami kesalahan apa pun, 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 diharuskan untuk mengembalikan D3DDDIERR_DEVICEREMOVED; namun, jika penghapusan perangkat mengganggu pengoperasian SOTargets (yang biasanya tidak boleh terjadi), driver dapat mengembalikan 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