PFND3DDDI_CREATEQUERY fungsi panggilan balik (d3dumddi.h)

  • Artikel

Fungsi CreateQuery membuat sumber daya sisi driver untuk kueri yang kemudian menjadi masalah runtime Microsoft Direct3D untuk diproses.

Sintaks

PFND3DDDI_CREATEQUERY Pfnd3dddiCreatequery;

HRESULT Pfnd3dddiCreatequery(
  HANDLE hDevice,
  D3DDDIARG_CREATEQUERY *unnamedParam2
)
{...}

Parameter

hDevice

Handel ke perangkat tampilan (konteks grafis).

unnamedParam2

pData [masuk, keluar]

Penunjuk ke struktur D3DDDIARG_CREATEQUERY yang mengidentifikasi kueri.

Menampilkan nilai

CreateQuery mengembalikan salah satu nilai berikut:

Menampilkan kode Deskripsi
S_OK Kueri berhasil dibuat.
E_OUTOFMEMORY CreateQuery tidak dapat mengalokasikan memori yang diperlukan untuk menyelesaikannya.

Keterangan

Runtime Direct3D memanggil fungsi CreateQuery driver tampilan mode pengguna dengan jenis kueri untuk membuat sumber daya untuk kueri. Driver tampilan mode pengguna membuat sumber daya berikut untuk jenis kueri:

  • BOOL untuk D3DDDIQUERYTYPE_EVENT. Sebelum merespons tentang suatu peristiwa, driver harus memastikan bahwa unit pemrosesan grafis (GPU) selesai memproses semua operasi yang terkait dengan peristiwa tersebut. Artinya, driver merespons tentang peristiwa setelah status akhir masalah terjadi. Driver harus selalu mengatur nilai BOOL peristiwa ke TRUE saat merespons.
  • UINT untuk D3DDDIQUERYTYPE_OCCLUSION. Driver mengatur variabel UINT ini ke jumlah piksel yang diteruskan pengujian z untuk semua primitif antara status awal dan akhir kueri masalah. Jika buffer kedalaman multisampel, driver menentukan jumlah piksel dari jumlah sampel. Namun, jika perangkat tampilan mampu melakukan akurasi z-test untuk setiap 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.
  • Struktur D3DDDIDEVINFO_VCACHE untuk D3DDDIQUERYTYPE_VCACHE. Driver merespons setelah status akhir masalah terjadi.
Untuk informasi selengkapnya tentang status kueri masalah, lihat D3DDDI_ISSUEQUERYFLAGS.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia di Windows Vista dan versi yang lebih baru dari sistem operasi Windows.
Target Platform Desktop
Header d3dumddi.h (termasuk D3dumddi.h)

Lihat juga

D3DDDIARG_CREATEQUERY

D3DDDIDEVINFO_VCACHE

D3DDDI_DEVICEFUNCS

D3DDDI_ISSUEQUERYFLAGS