FONTOBJ_cGetGlyphs 函数 (winddi.h)

  • 项目

FONTOBJ_cGetGlyphs函数是字体使用者的一项服务，它将字形句柄转换为指向字形数据的指针，这些指针在下次调用FONTOBJ_cGetGlyphs之前有效。

语法

ULONG FONTOBJ_cGetGlyphs(
       FONTOBJ *pfo,
  [in] ULONG   iMode,
       ULONG   cGlyph,
       HGLYPH  *phg,
       PVOID   *ppvGlyph
);

参数

pfo

指向包含要翻译的字形句柄的 FONTOBJ 结构的指针。

[in] iMode

指定数据是作为位图还是轮廓对象写入。 此参数可能是以下值之一：

值 含义
FO_GLYPHBITS 数据将由定义字形位图的 GLYPHBITS 结构组成。
FO_PATHOBJ 数据将由 PATHOBJ 结构组成，这些结构定义字形的轮廓。

若要确定是应填充路径还是应笔划路径，字体使用者应检查 IFIMETRICS 结构的 flInfo 成员。 如果设置了FM_INFO_RETURNS_STROKES标志，则应划去路径;否则，应填充路径。

cGlyph

指定要翻译的字形数。 唯一可接受的值为 1， (代码假定为 1，而不考虑) 指定的值。

phg

指向驱动程序提供的 cGlyph HGLYPH 结构数组的指针。

ppvGlyph

指向接收 GLYPHDATA 结构地址的内存位置的指针。 此结构的第一个成员是 GLYPHDEF 联合，它包含指向 GLYPHBITS 结构或 PATHOBJ 结构的指针，具体取决于 iMode 参数的值。 如果 iMode 的值FO_GLYPHBITS， (ppvGlyph) ->gdf 包含 GLYPHBITS 结构的地址。如果 iMode 的值FO_PATHOBJ， (ppvGlyph) -gdf> 包含 PATHOBJ 结构的地址。

返回值

如果函数成功，则返回值是传递给驱动程序的指针计数。 否则，它为零，并记录错误代码。

注解

如果驱动程序正在缓存字体，则应使用此函数。

要求

要求 值
最低受支持的客户端 在 Windows 2000 及更高版本的 Windows 操作系统中可用。
目标平台 通用
标头 winddi.h (包括 Winddi.h)
Library Win32k.lib
DLL Win32k.sys

另请参阅

DrvGetGlyphMode

FONTOBJ

FONTOBJ_cGetAllGlyphHandles

GLYPHBITS

IFIMETRICS

PATHOBJ