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

Функция обратного вызова PFNGETINFO (printoem.h)

  • Статья

Функция обратного вызова UNIFONTOBJ_GetInfo предоставляется драйвером Unidrv, чтобы подключаемые модули отрисовки могли получать сведения о шрифте или глифе.

Синтаксис

PFNGETINFO Pfngetinfo;

BOOL Pfngetinfo(
  _UNIFONTOBJ *unnamedParam1,
  DWORD unnamedParam2,
  PVOID unnamedParam3,
  DWORD unnamedParam4,
  PDWORD unnamedParam5
)
{...}

Параметры

unnamedParam1

Указатель на структуру UNIFONTOBJ , полученную функцией, которая выполняет обратный вызов к UNIFONTOBJ_GetInfo. Предоставляется вызывающим абонентом.

unnamedParam2

Указывает размер (в байтах) буфера, на который указывает pData. Предоставляется вызывающим абонентом.

unnamedParam3

Указатель на структуру, как показано в следующей таблице. Предоставляется вызывающим абонентом.

Значение dwInfoID Pdata Структура
UFO_GETINFO_FONTOBJ GETINFO_FONTOBJ
UFO_GETINFO_GLYPHBITMAP GETINFO_GLYPHBITMAP
UFO_GETINFO_GLYPHSTRING GETINFO_GLYPHSTRING
UFO_GETINFO_GLYPHWIDTH GETINFO_GLYPHWIDTH
UFO_GETINFO_MEMORY GETINFO_MEMORY
UFO_GETINFO_STDVARIABLE GETINFO_STDVAR

Дополнительные сведения см. в таблице в разделе Примечания .

unnamedParam4

Указывает тип структуры, на которую указывает pData. Предоставляется вызывающим абонентом. Дополнительные сведения см. в таблице в разделе Примечания .

unnamedParam5

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

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

Возвращает значение BOOL . Если операция выполнена успешно, функция возвращает значение TRUE. В противном случае возвращается значение FALSE.

Комментарии

Функция обратного вызова UNIFONTOBJ_GetInfo позволяет подключаемого модуля отрисовки вызывать Unidrv для получения сведений о шрифте или глифе из GDI, необходимых для обработки настраиваемых операций управления шрифтами .

Подключаемый модуль отрисовки получает адрес функции UNIFONTOBJ_GetInfo в структуре UNIFONTOBJ , который передается методам настройки шрифта.

Тип сведений, возвращаемых функцией, зависит от входных аргументов. Вызывающий объект предоставляет значения для dwInfoID, pData и dwDataSize , чтобы указать тип нужной информации. В следующей таблице перечислены типы возвращаемых сведений. Дополнительные сведения см. в описании структуры.

Pdata Структура Возвращаемые сведения
GETINFO_FONTOBJ Структура FONTOBJ, описывающая текущий шрифт.
GETINFO_GLYPHBITMAP Битовое изображение одного глифа.
GETINFO_GLYPHSTRING Массив описателей глифов в указанном формате.
GETINFO_GLYPHWIDTH Общая ширина набора глифов.
GETINFO_MEMORY Оставшийся объем доступной памяти принтера.
GETINFO_STDVAR Текущее значение для одной или нескольких стандартных переменных Unidrv.

Если буфер, описываемый pData и dwDataSize , слишком мал для получения структуры, указанной dwInfoID, функция загружает требуемый размер буфера в расположение, на которое указывает pcbNeeded, и возвращает значение FALSE.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть printoem.h (включая Printoem.h)