struktur D3DHAL_DP2CREATEQUERY (d3dhal.h)

Artikel
08/07/2023

DirectX 9.0 dan versi yang lebih baru saja.

Satu atau beberapa struktur D3DHAL_DP2CREATEQUERY diurai dari buffer perintah oleh panggilan balik D3dDrawPrimitives2 ketika anggota bCommand struktur D3DHAL_DP2COMMAND diatur ke D3DDP2OP_CREATEQUERY, dan digunakan untuk membuat sumber daya untuk kueri.

Sintaks

typedef struct _D3DHAL_DP2CREATEQUERY {
  DWORD        dwQueryID;
  D3DQUERYTYPE QueryType;
} D3DHAL_DP2CREATEQUERY;

Anggota

dwQueryID

Mengidentifikasi kueri.

QueryType

Menentukan nilai dari enumerasi D3DQUERYTYPE yang menunjukkan kemampuan kueri tempat driver membuat sumber daya.

Keterangan

Runtime menggunakan D3DHAL_DP2CREATEQUERY untuk mengidentifikasi setiap kueri dengan pengidentifikasi unik dan jenis kueri. Panggilan balik D3dDrawPrimitives2 driver harus memproses struktur D3DHAL_DP2CREATEQUERY wPrimitiveCount dari buffer perintah. Nilai wPrimitiveCount ditentukan dalam struktur D3DHAL_DP2COMMAND. Driver mengurai struktur ini dan membuat sumber daya untuk kueri yang mereka wakili seperlunya.

Driver membuat sumber daya untuk jenis kueri berikut:

BOOL untuk D3DQUERYTYPE_EVENT. Sebelum merespons dengan D3DDP2OP_RESPONSEQUERY untuk suatu peristiwa, driver harus memastikan bahwa unit pemrosesan grafis (GPU) selesai memproses semua operasi D3DHAL_DP2OPERATION yang terkait dengan peristiwa tersebut. Artinya, driver hanya merespons setelah status ISSUE_END peristiwa terjadi. Driver harus selalu mengatur nilai BOOL peristiwa ke TRUE saat merespons.
DWORD untuk D3DQUERYTYPE_OCCLUSION. Driver mengatur DWORD ini ke jumlah piksel yang diteruskan uji z untuk semua primitif antara awal dan akhir kueri. Jika buffer kedalaman multisampel, driver menentukan jumlah piksel dari jumlah sampel. Namun, jika perangkat tampilan mampu melakukan akurasi z-test per multisample, konversi ke jumlah piksel umumnya harus dibulatkan. Aplikasi kemudian dapat memeriksa hasil oklusi terhadap 0, untuk secara efektif berarti "sepenuhnya terakludasi". Driver yang mengonversi jumlah multisampled menjadi jumlah piksel harus mendeteksi perubahan multisampling target render dan terus menghitung hasil kueri dengan tepat.
D3DDEVINFO_VCACHE struktur untuk D3DQUERYTYPE_VCACHE.