PFND3DDDI_SETMARKER fungsi panggilan balik (d3dumddi.h)
Memberi tahu driver tampilan mode pengguna bahwa ia harus menghasilkan stempel waktu baru jika ada pekerjaan GPU yang telah selesai sejak panggilan terakhir ke pfnSetMarker. Secara opsional diimplementasikan oleh driver Windows Display Driver Model (WDDM) 1.3 dan yang lebih baru yang berjalan pada perangkat keras Microsoft Direct3D Level 9. (Lihat persyaratan dalam peningkatan performa penyajian Direct3D.) Untuk perangkat keras yang lebih canggih, driver harus menerapkan fungsi SetMarker .
Sintaks
PFND3DDDI_SETMARKER Pfnd3dddiSetmarker;
HRESULT Pfnd3dddiSetmarker(
HANDLE hDevice
)
{...}
Parameter
hDevice
Handel ke perangkat tampilan (konteks grafis).
Menampilkan nilai
Mengembalikan S_OK atau hasil kesalahan yang sesuai jika fungsi tidak berhasil diselesaikan.
Keterangan
Jika jenis peristiwa penanda dari parameter Jenis fungsi pfnSetMarkerMode tidak D3DDDIMT_NONE, driver tampilan mode pengguna harus melakukan prosedur ini dengan setiap panggilan ke pfnSetMarker:
- Menaikkan nilai anggota APISequenceNumber dari struktur D3DDDICB_LOGUMDMARKER .
- Tentukan konteks mana yang terkait dengan panggilan render antarmuka driver perangkat (DDI) utas tunggal yang dikirimkan berfungsi dengan panggilan terakhir ke pfnSetMarker. Untuk setiap konteks tersebut:
- Jika buffer perintah untuk konteks kosong, jangan lakukan apa pun.
- Sebaliknya:
- Pastikan bahwa lebih banyak memori tersedia dalam buffer riwayat konteks. Siram buffer jika perlu.
- Tambahkan entri lain ke buffer nomor urutan API konteks yang berisi 32 bit rendah dari nilai APISequenceNumber saat ini.
- Sampel dan tulis stempel waktu yang sesuai untuk jenis peristiwa penanda saat ini.
- Perbarui data pelacakan yang akan digunakan lain kali pfnSetMarker dipanggil.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 8.1,WDDM 1.3 dan yang lebih baru |
Server minimum yang didukung | Windows Server 2012 R2 |
Target Platform | Desktop |
Header | d3dumddi.h (termasuk D3d10umddi.h) |