drvGetGlyphMode 函数 (winddi.h)

DrvGetGlyphMode 函数告知 GDI 如何缓存字形信息。

语法

ULONG DrvGetGlyphMode(
  [in] DHPDEV  unnamedParam1,
  [in] FONTOBJ *unnamedParam2
);

参数

[in] unnamedParam1

物理设备的 PDEV 结构的句柄。

[in] unnamedParam2

指向 FONTOBJ 结构的指针,可以查询该结构以查找字号、转换和其他字体属性。

返回值

DrvGetGlyphMode 返回以下值之一:

返回代码 说明
FO_GLYPHBITS
GDI 应缓存此字体的所有字形数据。
FO_HGLYPHS
设备自行缓存字体,因此 GDI 应仅缓存此字体的字形句柄。
FO_PATHOBJ
GDI 应缓存此字体的 PATHOBJ 结构。

注解

GDI 调用驱动程序的 DrvGetGlyphMode 例程来确定应为特定字体缓存的字体信息范围;也就是说, DrvGetGlyphMode 确定 GDI 在其字体缓存中存储的内容。 自行缓存字体的设备应返回FO_HGLYPHS,以最大程度地减少字体的存储要求。

GDI 为每个字体实现调用 DrvGetGlyphMode 。 例如,驱动程序可能希望下载大于 12 磅的点大小的轮廓,但要下载小字体的光栅图像。 但是,GDI 保留拒绝此请求的权利。

驱动程序必须检查 FONTOBJ 结构的 flFontType 成员的RASTER_FONTTYPE位,以确定字形的实际形式。 如果设置了此位,则 GDI 发送位图;否则,它将发送 PATHOBJ 结构。

调用 DrvGetGlyphMode 时,关联的 FONTOBJ 未完全正常运行。 GDI 仅保证 IFIMETRICS 结构和名义到设备的转换是正确的。

DrvGetGlyphMode 是可选的驱动程序函数。 如果未提供此函数,则默认情况下,GDI 将存储光栅字体。

要求

要求
目标平台 桌面
标头 winddi.h (包括 Winddi.h)

另请参阅

FONTOBJ

FONTOBJ_cGetGlyphs

GLYPHDEF

GLYPHPOS

IFIMETRICS

PATHOBJ

STROBJ