fungsi FONTOBJ_cGetGlyphs (winddi.h)

Artikel
08/27/2023

Fungsi FONTOBJ_cGetGlyphs adalah layanan untuk konsumen font yang menerjemahkan handel glyph ke dalam pointer ke data glyph, yang valid hingga panggilan berikutnya ke FONTOBJ_cGetGlyphs.

Sintaks

ULONG FONTOBJ_cGetGlyphs(
       FONTOBJ *pfo,
  [in] ULONG   iMode,
       ULONG   cGlyph,
       HGLYPH  *phg,
       PVOID   *ppvGlyph
);

Parameter

pfo

Penunjuk ke struktur FONTOBJ yang berisi handel glyph yang akan diterjemahkan.

[in] iMode

Menentukan apakah data akan ditulis sebagai bitmap atau sebagai objek kerangka. Parameter ini bisa menjadi salah satu nilai berikut:

Nilai	Makna
FO_GLYPHBITS	Data akan terdiri dari struktur GLYPHBITS yang menentukan bitmap glyph.
FO_PATHOBJ	Data akan terdiri dari struktur PATHOBJ yang menentukan kerangka glyph. Untuk menentukan apakah jalur harus diisi atau di-stroke, konsumen font harus memeriksa anggota flInfo dari struktur IFIMETRICS . Jika bendera FM_INFO_RETURNS_STROKES diatur, jalur harus di-stroke; jika tidak, jalur harus diisi.

cGlyph

Menentukan jumlah glyph yang akan diterjemahkan. Satu-satunya nilai yang dapat diterima adalah 1 (kode mengasumsikan 1, terlepas dari nilai yang ditentukan).

phg

Penunjuk ke array struktur HGLYPH cGlyph yang disediakan oleh driver.

ppvGlyph

Pointer ke lokasi memori yang menerima alamat struktur GLYPHDATA . Anggota pertama dari struktur ini adalah serikat GLYPHDEF , yang berisi penunjuk ke struktur GLYPHBITS atau struktur PATHOBJ, tergantung pada nilai parameter iMode . Jika nilai iMode FO_GLYPHBITS, (ppvGlyph)->gdf berisi alamat struktur GLYPHBITS. Jika nilai iMode FO_PATHOBJ, (ppvGlyph)->gdf berisi alamat struktur PATHOBJ.

Mengembalikan nilai

Nilai yang dikembalikan adalah hitungan pointer yang diteruskan ke driver jika fungsi berhasil. Jika tidak, ini adalah nol, dan kode kesalahan dicatat.

Keterangan

Fungsi ini harus digunakan jika driver men-cache font.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows 2000 dan versi yang lebih baru dari sistem operasi Windows.
Target Platform	Universal
Header	winddi.h (termasuk Winddi.h)
Pustaka	Win32k.lib
DLL	Win32k.sys