struktur DD_GETFORMATDATA (d3dhal.h)
DirectX 8.0 dan versi yang lebih baru saja.
DD_GETFORMATDATA adalah struktur data yang diacu oleh bidang lpvDataDD_GETDRIVERINFODATA untuk kueri DD_GETDRIVERINFO2DATA dengan jenis D3DGDI2_TYPE_GETFORMAT.
Sintaks
typedef struct _DD_GETFORMATDATA {
DD_GETDRIVERINFO2DATA gdi2;
DWORD dwFormatIndex;
DDPIXELFORMAT format;
} DD_GETFORMATDATA;
Anggota
gdi2
Menentukan struktur DD_GETDRIVERINFO2DATA yang berisi data GetDriverInfo2 .
dwFormatIndex
Menentukan indeks format piksel yang akan dikembalikan.
format
Menerima format piksel aktual dalam struktur DDPIXELFORMAT .
Keterangan
Runtime mengidentifikasi format yang akan dikembalikan dengan indeks bilangan bulat yang nilainya bervariasi antara nol dan satu kurang dari jumlah format yang didukung yang dilaporkan sebelumnya oleh driver. Bagaimana indeks ini dipetakan ke format aktual diserahkan ke driver. Namun, setiap indeks harus memetakan secara unik ke satu format yang didukung. Urutan di mana format dilaporkan tidak signifikan.
Saat memproses permintaan GetDriverInfo2 ini, driver harus membaca dwFormatIndex dan memetakannya ke salah satu format yang didukung (mungkin dengan menggunakan dwFormatIndex sebagai indeks ke dalam array struktur DDPIXELFORMAT) lalu menyalin format tersebut ke bidang format bidang DD_GETFORMATDATA. Runtime menjamin bahwa runtime hanya meneruskan indeks ke driver yang berada dalam rentang nol hingga satu kurang dari jumlah format permukaan yang dilaporkan oleh driver. Rentang indeks harus divalidasi dalam build driver debug.
DirectX 9.0 dan versi yang lebih baru saja.Pada input, versi runtime DirectX yang sedang digunakan oleh aplikasi ditentukan dalam anggota dwSize dari struktur DDPIXELFORMAT dalam format. Anggota dwSize ini diatur ke DD_RUNTIME_VERSION, yang 0x00000900 untuk DirectX 9.0.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header | d3dhal.h (termasuk D3dhal.h) |