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

Статья
08/27/2023

Функция DrvQueryAdvanceWidths возвращает ширину символов для указанного набора глифов.

Синтаксис

BOOL DrvQueryAdvanceWidths(
        DHPDEV  dhpdev,
        FONTOBJ *pfo,
        ULONG   iMode,
  [in]  HGLYPH  *phg,
  [out] PVOID   pvWidths,
        ULONG   cGlyphs
);

Параметры

dhpdev

Обработайте PDEV физического устройства, которое ранее было возвращено DrvEnablePDEV.

pfo

Указатель на структуру FONTOBJ , которая идентифицирует экземпляр шрифта.

iMode

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

Значение	Значение
QAW_GETEASYWIDTHS	Ширина символа возвращается в виде массива чисел с фиксированной запятой 12,4. Этот режим не будет использоваться, если ширина превышает диапазон представления 12,4. Эта подпрограмма должна вычислять ширину как можно быстрее. Если не удается эффективно выполнить вычисление ширины символов глифа, драйвер должен записать 0xFFFF в буфер для этого глифа. Функция возвращает DDI_ERROR при возникновении ошибки, FALSE , если не все ширины можно эффективно вычислить для этого режима, или TRUE во всех остальных случаях.
QAW_GETWIDTHS	Ширина символов записывается в виде массива чисел с фиксированной запятой 12,4. Этот режим не будет использоваться, если ширина превышает диапазон представления 12,4. Функция возвращает значение TRUE в случае успешного выполнения.

Значение

QAW_GETEASYWIDTHS

Ширина символа возвращается в виде массива чисел с фиксированной запятой 12,4. Этот режим не будет использоваться, если ширина превышает диапазон представления 12,4. Эта подпрограмма должна вычислять ширину как можно быстрее. Если не удается эффективно выполнить вычисление ширины символов глифа, драйвер должен записать 0xFFFF в буфер для этого глифа. Функция возвращает DDI_ERROR при возникновении ошибки, FALSE , если не все ширины можно эффективно вычислить для этого режима, или TRUE во всех остальных случаях.

QAW_GETWIDTHS

Ширина символов записывается в виде массива чисел с фиксированной запятой 12,4. Этот режим не будет использоваться, если ширина превышает диапазон представления 12,4. Функция возвращает значение TRUE в случае успешного выполнения.

[in] phg

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

[out] pvWidths

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

cGlyphs

Указывает количество глифов во входном буфере, на который указывает phg.

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

Возвращаемое значение зависит от значения параметра iMode .

Требования


Целевая платформа	Персональный компьютер
Верхняя часть	winddi.h (включая Winddi.h)

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

DrvEnablePDEV

FONTOBJ

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