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)

另请参阅

DEVINFO

DrvEnablePDEV

DrvFree

DrvLoadFontFile

DrvQueryFontData

DrvQueryFontTree

FD_GLYPHSET

FD_KERNINGPAIR

IFIMETRICS