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 |