drvQueryFont 函数 (winddi.h)

GDI 使用 DrvQueryFont 函数获取给定字体的 IFIMETRICS 结构。

语法

PIFIMETRICS DrvQueryFont(
  DHPDEV    dhpdev,
  ULONG_PTR iFile,
  ULONG     iFace,
  ULONG_PTR *pid
);

参数

dhpdev

标识物理设备的 PDEV 的句柄。 PDEV 是从先前调用 DrvEnablePDEV 返回的

iFile

指向驱动程序定义的值的指针,该值标识驱动程序字体文件。 此指针由 DrvLoadFontFile 返回。 对于设备驻留字体,此参数为零。

iFace

指定驱动程序字体的从 1 开始的索引。 GDI 可以从 DEVINFO 结构查询字体数。

pid

指向内存位置的指针,其中包含不再需要 IFIMETRICS 结构时 GDI 传递给 DrvFree 的驱动程序定义值的地址。 根据驱动程序管理内存的方式,此值可以识别结构、确定其分配方式,或者根本不执行任何操作。

返回值

返回值是指向 IFIMETRICS 结构的指针,该结构描述给定字体(如果函数成功)。 否则,它为 NULL,并记录错误代码。

注解

驱动程序填充 IFIMETRICS 结构。

在关联 PDEV 的范围内,IFIMETRICS 结构必须保持不变。

如果 DEVINFO 中的字体数为 -1 且 iFace 为零,则驱动程序应返回它支持的字体数。

对于使用特定于驱动程序或设备特定字体的字体驱动程序和驱动程序,需要 DrvQueryFont

要求

   
目标平台 桌面
标头 winddi.h (包括 Winddi.h)

另请参阅

DEVINFO

DrvEnablePDEV

DrvFree

DrvLoadFontFile

IFIMETRICS