PFND3DWDDM1_3DDI_SETMARKERMODE fungsi panggilan balik (d3d10umddi.h)

Memberi tahu driver tampilan mode pengguna bahwa driver tersebut harus mendukung jenis peristiwa penanda Pelacakan Peristiwa untuk Windows (ETW). Harus diimplementasikan oleh Windows Display Driver Model (WDDM) 1.3 dan driver yang lebih baru.

Sintaks

PFND3DWDDM1_3DDI_SETMARKERMODE Pfnd3dwddm13DdiSetmarkermode;

void Pfnd3dwddm13DdiSetmarkermode(
  D3D10DDI_HDEVICE hDevice,
  D3DWDDM1_3DDI_MARKER_TYPE Type,
  UINT Flags
)
{...}

Parameter

hDevice

Handel ke perangkat tampilan (konteks grafis).

Type

Nilai dari enumerasi D3DWDDM1_3DDI_MARKER_TYPE yang menunjukkan jenis peristiwa penanda yang harus didukung driver.

Flags

Nilai UINT yang menunjukkan apakah driver harus memberikan info kustom dalam buffer perintah. Jika diatur ke D3DWDDM1_3DDI_SETMARKERMODE_CUSTOMDRIVEREVENTS, driver harus membuat anotasi dan buffer perintah instrumen dengan info peristiwa kustom. Jika tidak, driver tidak boleh membuat anotasi buffer perintah.

Anotasi dapat berupa string teks di lokal Inggris-AS, atau dalam bentuk nilai indeks ke lokasi dalam tabel string. Untuk opsi terakhir, driver juga harus menerapkan fungsi yang menjelaskan string yang ditunjukkan oleh nilai indeks.

Menampilkan nilai

Tidak ada

Keterangan

Driver dapat menggunakan fungsi panggilan balik pfnSetErrorCb untuk mengatur kode kesalahan.

Ikuti panduan ini saat Anda menyiapkan peristiwa penanda jenis profil di driver mode pengguna Anda, yang ditunjukkan oleh jenis D3DWDDM1_3DDI_MARKER_TYPE_PROFILE :

• Gunakan instrumentasi ringan yang tidak menghasilkan korelasi yang kuat dengan batas perintah grafis.
• Driver harus dapat mengambil sampel stempel waktu GPU di akhir alur grafis.
• Jangan gunakan perintah pengambilan sampel yang menempatkan beban performa tinggi pada alur grafis, seperti perintah tunggu diam. Agar dapat melengkapi peristiwa penanda jenis profil, driver Anda seharusnya tidak perlu membersihkan alur atau cache.

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	d3d10umddi.h (termasuk D3d10umddi.h)

Lihat juga

D3DWDDM1_3DDI_MARKER_TYPE