PFND3DDDI_SETMARKERMODE fungsi panggilan balik (d3dumddi.h)
Memberi tahu driver tampilan mode pengguna bahwa driver tersebut harus mendukung jenis peristiwa penanda Pelacakan Peristiwa untuk Windows (ETW). 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 SetMarkerMode .
Sintaks
PFND3DDDI_SETMARKERMODE Pfnd3dddiSetmarkermode;
HRESULT Pfnd3dddiSetmarkermode(
HANDLE hDevice,
D3DDDI_MARKERTYPE Type,
UINT Flags
)
{...}
Parameter
hDevice
Handel ke perangkat tampilan (konteks grafis).
Type
Nilai dari enumerasi D3DDDI_MARKERTYPE 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 D3DDDI_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
Mengembalikan S_OK atau hasil kesalahan yang sesuai jika fungsi tidak berhasil diselesaikan.
Keterangan
Ikuti panduan ini saat Anda menyiapkan peristiwa penanda jenis profil di driver mode pengguna Anda, yang ditunjukkan oleh jenis D3DDDIMT_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 | d3dumddi.h (termasuk D3d10umddi.h) |