Fungsi DrvQueryFontTree (winddi.h)
Fungsi DrvQueryFontTree menyediakan GDI dengan penunjuk ke struktur yang mendefinisikan salah satu hal berikut:
- Pemetaan dari handel Unicode ke glyph, termasuk varian glyph
- Pemetaan pasangan kerning ke handel kerning
Sintaks
PVOID DrvQueryFontTree(
DHPDEV dhpdev,
ULONG_PTR iFile,
ULONG iFace,
ULONG iMode,
ULONG_PTR *pid
);
Parameter
dhpdev
Mengidentifikasi perangkat dengan handel ke PDEV-nya, dikembalikan dari panggilan sebelumnya ke DrvEnablePDEV.
iFile
Mengidentifikasi file font driver. Nilai ini dikembalikan oleh DrvLoadFontFile.
iFace
Menentukan indeks font driver berbasis satu.
iMode
Menentukan jenis informasi yang akan disediakan. Ini bisa menjadi salah satu nilai berikut:
Nilai | Makna |
---|---|
QFT_GLYPHSET | GDI meminta penunjuk ke struktur FD_GLYPHSET yang menentukan pemetaan dari satu karakter Unicode ke handel glyph. |
QFT_KERNPAIRS |
GDI meminta penunjuk ke array struktur FD_KERNINGPAIR yang diurutkan dan dihentikan null.
Pasangan kerning harus disimpan dalam urutan yang meningkat. Kunci primer adalah karakter Unicode kedua; kunci sekunder adalah karakter Unicode pertama dalam pasangan kerning. |
pid
Penunjuk ke lokasi memori yang menyimpan alamat nilai yang ditentukan driver. GDI meneruskan konten *pid ke DrvFree, bersama dengan pointer yang dikembalikan, ketika struktur FD_GLYPHSET atau array struktur FD_KERNINGPAIR tidak lagi diperlukan. Tergantung pada bagaimana memori dikelola dalam driver, nilai yang ditentukan driver dapat mengidentifikasi struktur, mengidentifikasi caranya dialokasikan, atau tidak melakukan apa pun sama sekali.
Mengembalikan nilai
Nilai yang dikembalikan adalah penunjuk ke struktur yang diminta jika fungsi berhasil. Jika tidak, ini adalah NULL, dan kode kesalahan dicatat.
Keterangan
Struktur yang dikembalikan harus tetap tidak dimodifikasi sampai GDI memanggil DrvFree dengan alamat struktur.
DrvQueryFontTree diperlukan untuk driver font dan driver yang menggunakan font khusus perangkat.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Desktop |
Header | winddi.h (termasuk Winddi.h) |