DrvDestroyFont

VOID DrvDestroyFont(

    IN FONTOBJ *pfo

   );

DrvDestroyFont notifies the driver that a font realization is no longer needed and that the driver can now free any associated data structures it has allocated.

Parameters

pfo
Points to the FONTOBJ structure that identifies the font instance.

Comments

If the DEVICE_FONTTYPE flag is set in the flFontType member of the FONTOBJ structure, the driver should release any resources or memory identified with both the pvConsumer and pvProducer members of FONTOBJ. Otherwise, it should release only memory and resources identified with pvConsumer.

The driver must reset the pvConsumer and pvProducer members to null if it uses them.

GDI calls DrvDestroyFont once for the font producer and once again for the font consumer.

GDI guarantees that DrvDestroyFont and DrvTextOut never overlap; consequently, the driver can rely on cached information while processing a DrvTextOut call.

This function must be implemented if the driver allocates resources that must be released when the font instance is destroyed.

See Also

DrvTextOut, FONTOBJ