Fungsi DrvGetGlyphMode (winddi.h)

Artikel
03/04/2024

Fungsi DrvGetGlyphMode memberi tahu GDI cara menyimpan informasi glyph.

Sintaks

ULONG DrvGetGlyphMode(
  [in] DHPDEV  unnamedParam1,
  [in] FONTOBJ *unnamedParam2
);

Parameter

[in] unnamedParam1

Tangani ke struktur PDEV perangkat fisik.

[in] unnamedParam2

Penunjuk ke struktur FONTOBJ yang dapat dikueri untuk menemukan ukuran font, transformasi, dan atribut font lainnya.

Mengembalikan nilai

DrvGetGlyphMode mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
FO_GLYPHBITS	GDI harus menyimpan semua data glyph untuk font ini.
FO_HGLYPHS	Perangkat cache font sendiri, jadi GDI harus cache hanya handel glyph untuk font ini.
FO_PATHOBJ	GDI harus menyimpan struktur PATHOBJ untuk font ini.

Keterangan

GDI memanggil rutinitas DrvGetGlyphMode driver untuk menentukan rentang informasi font yang harus di-cache untuk font tertentu; artinya, DrvGetGlyphMode menentukan apa yang disimpan GDI dalam cache font-nya. Perangkat yang menyimpan font sendiri harus mengembalikan FO_HGLYPHS untuk meminimalkan persyaratan penyimpanan untuk font.

GDI memanggil DrvGetGlyphMode untuk setiap realisasi font. Misalnya, driver mungkin ingin mengunduh kerangka untuk ukuran titik yang lebih besar dari 12 poin, tetapi gambar raster untuk font yang lebih kecil. Namun, GDI berhak menolak permintaan ini.

Driver harus memeriksa bit RASTER_FONTTYPE anggota flFontType dari struktur FONTOBJ untuk menentukan bentuk sebenarnya dari glyph. Jika bit ini diatur, GDI mengirim bitmap; jika tidak, ia mengirim struktur PATHOBJ .

Pada saat panggilan ke DrvGetGlyphMode, FONTOBJ terkait tidak berfungsi penuh. GDI hanya menjamin bahwa struktur IFIMETRICS dan transformasi nosional-ke-perangkat sudah benar.

DrvGetGlyphMode adalah fungsi driver opsional. Jika fungsi ini tidak disediakan, GDI akan menyimpan font raster secara default.