struktur D3DDDIDEVINFO_VCACHE (d3dumddi.h)
Struktur D3DDDIDEVINFO_VCACHE menjelaskan informasi vertex-cache perangkat.
Sintaks
typedef struct _D3DDDIDEVINFO_VCACHE {
[out] UINT Pattern;
[out] UINT OptMethod;
[out] UINT CacheSize;
[out] UINT MagicNumber;
} D3DDDIDEVINFO_VCACHE;
Anggota
[out] Pattern
Pola bit. Driver harus menentukan pola bit sebagai nilai KODE empat karakter CACH (FOURCC). Driver dapat menggunakan makro MAKEFOURCC berikut untuk menentukan nilai FOURCC sebagai CACH:
MAKEFOURCC('C', 'A', 'C', 'H');
[out] OptMethod
Metode pengoptimalan jala. Driver dapat menggunakan salah satu nilai berikut untuk menentukan pengoptimalan jala yang digunakannya.
| Nilai | Makna |
|---|---|
| D3DXMESHOPT_STRIPREORDER (0) | Pengoptimalan strip terpanjang |
| D3DXMESHOPT_VCACHE (1) | Pengoptimalan berbasis vertex-cache |
[out] CacheSize
Ukuran efektif, dalam entri, yang dioptimalkan driver cache vertex. Ukuran cache aktual tidak diperlukan untuk menjadi ukuran yang ditentukan dalam CacheSize karena ukuran cache aktual lebih besar dalam sebagian besar situasi. Driver menentukan ukuran yang dioptimalkan dalam CacheSize hanya jika juga menentukan D3DXMESHOPT_VCACHE di anggota OptMethod .
[out] MagicNumber
Angka yang harus digunakan sebagai bagian dari prosedur uji coba-dan-kesalahan saat menentukan kapan harus memulai ulang daftar strip. Angka ini bisa dari 1 hingga nilai yang ditentukan dalam anggota CacheSize . Biasanya, nilai terbaik berada di dekat CacheSize/2. Driver menentukan angka di MagicNumber hanya jika juga menentukan D3DXMESHOPT_VCACHE di anggota OptMethod .
Keterangan
Runtime Direct3D versi 9.0 dan yang lebih baru. Runtime Microsoft Direct3D memanggil fungsi CreateQuery driver untuk membuat sumber daya sisi driver untuk kueri vertex-cache. Dalam panggilan CreateQuery ini, runtime menentukan jenis kueri D3DDDIQUERYTYPE_VCACHE di anggota QueryType dari struktur D3DDDIARG_CREATEQUERY . Driver harus mengalokasikan struktur D3DDDIDEVINFO_VCACHE. Runtime kemudian memanggil fungsi IssueQuery driver untuk memproses kueri vertex-cache. Driver harus menyisipkan instruksi unit pemrosesan grafis (GPU) untuk menulis data vertex-cache ke alokasi. Untuk mengambil informasi vertex-cache dari driver, runtime memanggil fungsi GetQueryData driver. Dalam panggilan GetQueryData ini, driver harus mengunci alokasi dan mengembalikan data vertex-cache di anggota pData dari struktur D3DDDIARG_GETQUERYDATA yang ditujukkan oleh parameter pData .
Hanya runtime Direct3D versi 8.1. Runtime Direct3D memanggil fungsi GetInfo driver untuk mendapatkan informasi vertex-cache dari driver. Dalam panggilan GetInfo ini, runtime melewati bendera D3DDDIDEVINFOID_VCACHE di parameter DevInfoID . Driver menentukan informasi vertex-cache dalam struktur D3DDDIDEVINFO_VCACHE dan mengembalikannya di parameter pDevInfoStruct .
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia di Windows Vista dan versi yang lebih baru dari sistem operasi Windows. |
| Header | d3dumddi.h (termasuk D3dumddi.h) |