struktur DD_GETD3DQUERYDATA (d3dhal.h)

Artikel
03/08/2023

DirectX 9.0 dan versi yang lebih baru saja.

DD_GETD3DQUERYDATA adalah struktur data yang diacu oleh bidang lpvDataDD_GETDRIVERINFODATA untuk kueri DD_GETDRIVERINFO2DATA dengan jenis D3DGDI2_TYPE_GETD3DQUERY.

Sintaks

typedef struct _DD_GETD3DQUERYDATA {
  DD_GETDRIVERINFO2DATA gdi2;
  union {
    DWORD        dwQueryIndex;
    D3DQUERYTYPE QueryType;
  };
} DD_GETD3DQUERYDATA;

Anggota

gdi2

Menentukan struktur DD_GETDRIVERINFO2DATA yang berisi data GetDriverInfo2 .

dwQueryIndex

Menentukan indeks jenis kueri yang akan dikembalikan.

QueryType

Menerima nilai dari enumerasi D3DQUERYTYPE yang menentukan kemampuan kueri aktual.

Keterangan

Runtime mengidentifikasi jenis kueri yang akan dikembalikan dengan indeks bilangan bulat yang nilainya bervariasi antara nol dan satu kurang dari jumlah jenis kueri yang didukung yang dilaporkan sebelumnya oleh driver dalam kueri D3DGDI2_TYPE_GETD3DQUERYCOUNT. Bagaimana indeks ini dipetakan ke jenis kueri aktual diserahkan ke driver. Namun, setiap indeks harus memetakan secara unik ke satu jenis kueri yang didukung. Urutan di mana jenis kueri dilaporkan tidak signifikan.

Saat memproses permintaan GetDriverInfo2 ini, driver harus membaca nilai dalam gabungan seolah-olah itu adalah anggota dwQueryIndex dan memetakan nilai tersebut ke salah satu jenis kueri yang didukung (mungkin dengan menggunakan nilai di dwQueryIndex sebagai indeks ke dalam array nilai D3DQUERYTYPE). Driver kemudian harus menyalin jenis kueri tersebut ke dalam gabungan seolah-olah itu adalah anggota QueryType . Runtime menjamin bahwa runtime hanya meneruskan indeks ke driver yang berada dalam rentang nol hingga satu kurang dari jumlah jenis kueri yang dilaporkan oleh driver. Rentang indeks harus divalidasi dalam build driver debug.

Untuk informasi selengkapnya tentang D3DQUERYTYPE, lihat dokumentasi DirectX SDK.