PFND3DWDDM1_3DDI_GETMIPPACKING fungsi panggilan balik (d3d10umddi.h)

Artikel
02/22/2024

Untuk sumber daya ubin tertentu, mengembalikan berapa banyak mip yang dikemas, dan berapa banyak petak peta yang diperlukan untuk menyimpan semua mip yang dikemas.

Sintaks

PFND3DWDDM1_3DDI_GETMIPPACKING Pfnd3dwddm13DdiGetmippacking;

void Pfnd3dwddm13DdiGetmippacking(
  D3D10DDI_HDEVICE hDevice,
  D3D10DDI_HRESOURCE hTiledResource,
  UINT *pNumPackedMips,
  UINT *pNumTilesForPackedMips
)
{...}

Parameter

hDevice

Handel ke perangkat tampilan (konteks grafis).

hTiledResource

Handel ke sumber daya ubin.

pNumPackedMips

Penunjuk ke variabel yang menerima jumlah mips yang dikemas, untuk ikatan array tertentu, termasuk mip apa pun yang tidak menggunakan bentuk petak peta standar.

Jika tidak ada pengemasan, nilai nol harus dikembalikan.

pNumTilesForPackedMips

Penunjuk ke variabel yang menerima jumlah petak peta yang cocok dengan mips yang dikemas, untuk iringan array tertentu.

Parameter ini diabaikan jika *pNumPackedMips mengembalikan nol.

Menampilkan nilai

Tidak ada

Keterangan

Driver dapat menggunakan fungsi panggilan balik pfnSetErrorCb untuk mengatur kode kesalahan. Driver dapat mengatur E_INVALIDARG jika parameter input tidak ada atau NULL.

Mips yang dikemas mencakup kasus di mana beberapa petak peta berbagi mips kecil dan juga mips yang perangkat tertentu tidak dapat menggunakan bentuk petak peta standar. Dimungkinkan bagi seluruh sumber daya untuk dianggap dikemas.

Aplikasi tidak diberi tahu bentuk petak peta atau tata letak untuk mip yang dikemas dan hanya harus memetakan semua atau tidak ada petak peta yang dikemas jika salah satu mipmap akan diakses. Jika tidak, pemetaan piksel individual yang diamati yang diakses tidak terdefinisi dan khusus untuk vendor perangkat keras independen (IHV).

Mipmaps yang memiliki dimensi piksel yang sepenuhnya mengisi setidaknya satu petak peta berbentuk standar di semua dimensi tidak diizinkan untuk dianggap sebagai bagian dari kumpulan mip yang dikemas. Jika tidak, runtime akan menghapus perangkat pada driver yang tidak valid.
Salah satu contoh dimensi bahwa perangkat dapat secara valid menabrak petak peta yang dikemas (artinya IHV dapat menggunakan perincian petak peta kustomnya sendiri) adalah mip yang setidaknya satu petak peta lebar tetapi kurang dari tinggi petak peta. Idealnya, perangkat akan menggunakan perincian petak peta standar untuk kasus ini (sehingga aplikasi dapat mengelola petak peta dengan cara standar). Jika perangkat memang perlu menggunakan ubin kustom, aplikasi tidak diberi tahu apa perincian petak peta (hanya berapa banyak petak peta yang terlibat dalam pengemasan secara keseluruhan), dan dengan demikian kehilangan beberapa kebebasan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8.1,WDDM 1.3
Server minimum yang didukung	Windows Server 2012 R2
Target Platform	Desktop
Header	d3d10umddi.h (termasuk D3d10umddi.h)

Lihat juga

pfnSetErrorCb

Bagikan melalui