drvDestroyFont 函数 (winddi.h)

DrvDestroyFont 函数通知驱动程序不再需要字体实现,并且驱动程序现在可以释放已分配的任何关联数据结构。

语法

void DrvDestroyFont(
  FONTOBJ *pfo
);

参数

pfo

指向用于标识字体实例的 FONTOBJ 结构的指针。

返回值

备注

DrvDestroyFont 函数仅在字体驱动程序和内核模式打印机驱动程序中调用。

如果在 FONTOBJ 结构的 flFontType 成员中设置了DEVICE_FONTTYPE标志,驱动程序应释放使用 FONTOBJ 的 pvConsumerpvProducer 成员标识的任何资源或内存。 否则,它应仅释放使用 pvConsumer 标识的内存和资源。

如果驱动程序使用 pvConsumerpvProducer 成员,则必须将其重置为 NULL

GDI 为字体生成者调用 DrvDestroyFont 一次,再次调用字体使用者。

GDI 保证 DrvDestroyFontDrvTextOut 永不重叠;因此,驱动程序在处理 DrvTextOut 调用时可以依赖于缓存的信息。

如果字体驱动程序或内核模式打印机驱动程序在实现字体时分配资源,则必须实现此函数。

要求

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

另请参阅

DrvTextOut

FONTOBJ