getFontData 函数 (wingdi.h)
GetFontData 函数检索 TrueType 字体的字体指标数据。
语法
DWORD GetFontData(
[in] HDC hdc,
[in] DWORD dwTable,
[in] DWORD dwOffset,
[out] PVOID pvBuffer,
[in] DWORD cjBuffer
);
参数
[in] hdc
设备上下文的句柄。
[in] dwTable
要从中检索字体数据的字体指标表的名称。 此参数可以标识 Microsoft Corporation 发布的 TrueType 字体文件规范中记录的指标表之一。 如果此参数为零，则从 TrueType 字体文件的文件开头或 TrueType 集合文件的当前所选字体的数据开头检索信息。 若要从 TrueType 集合文件的开头检索数据，请指定“ttcf” (0x66637474) 。
[in] dwOffset
从字体指标表的开头到函数应开始检索信息的位置的偏移量。 如果此参数为零，则从 dwTable 参数指定的表的开头开始检索信息。 如果此值大于或等于表的大小，则会发生错误。
[out] pvBuffer
指向接收字体信息的缓冲区的指针。 如果此参数为 NULL，则该函数将返回字体数据所需的缓冲区大小。
[in] cjBuffer
要检索的信息的长度（以字节为单位）。 如果此参数为零， GetFontData 将返回 dwTable 参数中指定的数据的大小。
返回值
如果函数成功，则返回值是返回的字节数。
如果函数失败，则返回值GDI_ERROR。
注解
此函数旨在用于通过字体操作应用程序直接从字体文件中检索 TrueType 字体信息。 有关嵌入字体的信息，请参阅 字体嵌入参考。
应用程序有时可以使用 GetFontData 函数将 TrueType 字体与文档一起保存。 为此，应用程序通过检查 OUTLINETEXTMETRIC 结构的 otmfsType 成员来确定字体是否可以嵌入。 如果设置了 otmfsType 的第 1 位，则不允许嵌入字体。 如果第 1 位被清除，则可以嵌入字体。 如果设置了第 2 位，则嵌入为只读。 如果允许嵌入，应用程序可以检索整个字体文件，为 dwTable、 dwOffset 和 cbData 参数指定零。
如果应用程序尝试使用此函数检索非 TrueType 字体的信息，则会发生错误。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | wingdi.h (包括 Windows.h) |
| Library | Gdi32.lib |
| DLL | Gdi32.dll |