drvDestroyFont 函式 (winddi.h)
DrvDestroyFont函式會通知驅動程式不再需要字型實現,而且驅動程式現在可以釋放它配置的任何相關聯資料結構。
語法
void DrvDestroyFont(
FONTOBJ *pfo
);
參數
pfo
識別字型實例的 FONTOBJ 結構的指標。
傳回值
無
備註
DrvDestroyFont函式只會在字型驅動程式和核心模式印表機驅動程式中呼叫。
如果DEVICE_FONTTYPE旗標是在 FONTOBJ 結構的 flFontType 成員中設定,驅動程式應該釋放以 FONTOBJ 的 pvConsumer 和 pvProducer 成員識別的任何資源或記憶體。 否則,它應該只會釋放使用 pvConsumer識別的記憶體和資源。
驅動程式在使用 pvConsumer 和 pvProducer 成員時,必須將 pvConsumer 和 pvProducer 成員重設為 Null 。
GDI 會針對字型產生者呼叫 DrvDestroyFont 一次,然後再次呼叫字型取用者。
GDI 保證 DrvDestroyFont 和 DrvTextOut 永遠不會重迭;因此,驅動程式可以在處理 DrvTextOut 呼叫時依賴快取的資訊。
如果字型驅動程式或核心模式印表機驅動程式在實現字型時配置資源,則必須實作此函式。
規格需求
目標平台 | 桌上型 |
標頭 | winddi.h (包括 Winddi.h) |