FDDESTROYFONT (Compact 2013)

  • Article

3/28/2014

The FDDESTROYFONT function 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.

Syntax

VOID FDDESTROYFONT(FONTOBJ *pfo);

Parameters

  • pfo
    [in] Pointer to the FONTOBJ structure that identifies the font instance.

Return Value

None.

Remarks

The FDDESTROYFONT function is called only in font drivers and kernel-mode printer drivers.

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 FDDESTROYFONT once for the font producer and once again for the font consumer.

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

This function must be implemented if the font driver or kernel-mode printer driver allocates resources when it realizes fonts.

Requirements

Header

fontdrv.h

See Also

Reference

Fonts Functions