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)

Lihat juga

DEVINFO

DrvEnablePDEV

DrvFree

DrvLoadFontFile

DrvQueryFontData

DrvQueryFontTree

FD_GLYPHSET

FD_KERNINGPAIR

IFIMETRICS