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

Статья
02/07/2025

Функция обратного вызова 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, функция загружает требуемый размер буфера в расположение, указываемое pcbNeed и возвращает false.

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	printoem.h (include Printoem.h)

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