Fungsi DrvQueryFontTree (winddi.h)

Artikel
03/04/2024

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.