Поделиться через


Функция FONTOBJ_cGetGlyphs (winddi.h)

Функция FONTOBJ_cGetGlyphs — это служба для потребителя шрифта, которая преобразует дескрипторы глифов в указатели на данные глифов, которые действительны до следующего вызова FONTOBJ_cGetGlyphs.

Синтаксис

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

Параметры

pfo

Указатель на структуру FONTOBJ , содержащую дескрипторы глифа для перевода.

[in] iMode

Указывает, будут ли данные записываться в виде точечных рисунков или в виде объектов структуры. Этот параметр может иметь одно из следующих значений:

Значение Значение
FO_GLYPHBITS Данные будут состоять из структур GLYPHBITS , определяющих растровые изображения глифов.
FO_PATHOBJ Данные будут состоять из структур PATHOBJ , определяющих контуры глифов.

Чтобы определить, следует ли заполнять путь или обчеркивать, потребитель шрифта должен проверка элемент flInfo структуры IFIMETRICS. Если установлен флаг FM_INFO_RETURNS_STROKES, путь должен быть обчеркен; в противном случае путь должен быть заполнен.

cGlyph

Указывает количество глифов для перевода. Единственное допустимое значение — 1 (код предполагает 1, независимо от указанного значения).

phg

Указатель на массив структур HGLYPH cGlyph , предоставленных драйвером.

ppvGlyph

Указатель на расположение памяти, которое получает адрес структуры GLYPHDATA . Первым элементом этой структуры является объединение GLYPHDEF , содержащее указатель на структуру GLYPHBITS или PATHOBJ в зависимости от значения параметра iMode . Если значение iMode равно FO_GLYPHBITS, (ppvGlyph)->gdf содержит адрес структуры GLYPHBITS. Если значение iMode равно FO_PATHOBJ, (ppvGlyph)->gdf содержит адрес структуры PATHOBJ.

Возвращаемое значение

Возвращаемое значение — это количество указателей, переданных драйверу при успешном выполнении функции. В противном случае значение равно нулю и регистрируется код ошибки.

Комментарии

Эту функцию следует использовать, если драйвер кэширует шрифты.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows 2000 и более поздних версиях операционных систем Windows.
Целевая платформа Универсальное
Верхняя часть winddi.h (включая Winddi.h)
Библиотека Win32k.lib
DLL Win32k.sys

См. также раздел

DrvGetGlyphMode

FONTOBJ

FONTOBJ_cGetAllGlyphHandles

ГЛИФБИТЫ

IFIMETRICS

PATHOBJ