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

Статья
08/27/2023

Функция DrvQueryFontTree предоставляет GDI с указателем на структуру, которая определяет одно из следующих элементов:

Сопоставление из Юникода с дескрипторами глифов, включая варианты глифов
Сопоставление пар kerning с дескрипторами кернинга

Синтаксис

PVOID DrvQueryFontTree(
  DHPDEV    dhpdev,
  ULONG_PTR iFile,
  ULONG     iFace,
  ULONG     iMode,
  ULONG_PTR *pid
);

Параметры

dhpdev

Идентифицирует устройство с помощью дескриптора PDEV, возвращенного при предыдущем вызове DrvEnablePDEV.

iFile

Определяет файл шрифта драйвера. Это значение возвращается DrvLoadFontFile.

iFace

Задает одноуровневый индекс шрифта драйвера.

iMode

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

Значение	Значение
QFT_GLYPHSET	GDI запрашивает указатель на структуру FD_GLYPHSET , которая определяет сопоставления отдельных символов Юникода с дескрипторами глифов.
QFT_KERNPAIRS	GDI запрашивает указатель на отсортированный массив структур FD_KERNINGPAIR , заканчивающийся значением NULL. Пары kerning должны храниться в порядке увеличения. Первичный ключ — это второй символ Юникода; вторичный ключ — это первый символ Юникода в паре kerning.

Значение

QFT_GLYPHSET

GDI запрашивает указатель на структуру FD_GLYPHSET , которая определяет сопоставления отдельных символов Юникода с дескрипторами глифов.

QFT_KERNPAIRS

GDI запрашивает указатель на отсортированный массив структур FD_KERNINGPAIR , заканчивающийся значением NULL.

Пары kerning должны храниться в порядке увеличения. Первичный ключ — это второй символ Юникода; вторичный ключ — это первый символ Юникода в паре kerning.

pid

Указатель на расположение памяти с адресом определенного драйвером значения. GDI передает содержимое *pidв DrvFree вместе с возвращенным указателем, когда структура FD_GLYPHSET или массив FD_KERNINGPAIR структур больше не нужны. В зависимости от того, как в драйвере осуществляется управление памятью, определенное драйвером значение может определить структуру, способ ее выделения или вообще ничего не делать.

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

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