PFND3DDDI_SETMARKER fungsi panggilan balik (d3dumddi.h)

  • Artikel

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:

  1. Menaikkan nilai anggota APISequenceNumber dari struktur D3DDDICB_LOGUMDMARKER .
  2. 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:
    1. Jika buffer perintah untuk konteks kosong, jangan lakukan apa pun.
    2. 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.
    3. 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)

Lihat juga

SetMarker

pfnSetMarkerMode