Функция 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 |