drvQueryFontTree 函数 (winddi.h)
DrvQueryFontTree 函数为 GDI 提供指向定义以下其中一个结构的指针：
- 从 Unicode 到字形句柄的映射，包括字形变体
- 字距对到字距句柄的映射
语法
PVOID DrvQueryFontTree(
DHPDEV dhpdev,
ULONG_PTR iFile,
ULONG iFace,
ULONG iMode,
ULONG_PTR *pid
);
参数
dhpdev
通过从先前调用 DrvEnablePDEV 返回的 PDEV 的句柄来标识设备。
iFile
标识驱动程序字体文件。 此值由 DrvLoadFontFile 返回。
iFace
指定驱动程序字体的从 1 开始的索引。
iMode
指定要提供的信息的类型。 这可以是以下值之一：
| 值 | 含义 |
|---|---|
| QFT_GLYPHSET | GDI 请求指向 FD_GLYPHSET 结构的指针，该结构定义从单个 Unicode 字符到字形句柄的映射。 |
| QFT_KERNPAIRS |
GDI 请求指向已排序的以 null 结尾 的FD_KERNINGPAIR 结构的数组的指针。
应按递增顺序存储字距对。 主键是第二个 Unicode 字符;辅助键是字距调整对中的第一个 Unicode 字符。 |
pid
指向包含驱动程序定义值的地址的内存位置的指针。 当不再需要FD_GLYPHSET结构或FD_KERNINGPAIR结构数组时，GDI 会将 *pid 的内容以及返回的指针传递给 DrvFree。 根据在驱动程序中管理内存的方式，驱动程序定义的值可以识别结构、确定其分配方式，或者根本不执行任何操作。
返回值
如果函数成功，则返回值是指向所请求结构的指针。 否则，它为 NULL，并记录错误代码。
注解
在 GDI 使用结构的地址调用 DrvFree 之前，返回的结构必须保持未修改状态。
使用特定于设备的字体的字体驱动程序和驱动程序需要 DrvQueryFontTree。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | 桌面 |
| 标头 | winddi.h (包括 Winddi.h) |