This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

PfDynamicUnload(), PfDynamicUnloadCx()

Unload a dynamically loaded font

Synopsis:

#include <photon/Pf.h>
long PfDynamicUnload( long lDynamicFontID );

#include <font_api.h>
long PfDynamicUnloadCx( struct _Pf_ctrl * context,
                        long lDynamicFontID );

Arguments:

context: (PfDynamicUnloadCx() only) A pointer to the font context to use, returned by PfAttachCx() or PfAttachDllCx().
lDynamicFontID: The font ID, returned by PfDynamicLoad(), of the font that you want to unload.

Library:

PfDynamicUnload(): ph
PfDynamicUnloadCx(): font

Description:

This function unloads a dynamically loaded font.

Returns:

0L on success, or -1L if an error occurred (errno is set).

Errors:

PfDynamicUnload():

ESRCH: The function couldn't locate the given dynamic font ID or font file entry.
EBADF: An error occurred when attempting to close and remove the font file from the affected library.
ENOMEM: Not enough memory was available to proceed with the unload.
EINVAL: An invalid condition was encountered, possibly due to an invalid font file.

PfDynamicUnloadCx():

ERANGE: Provided ID is less than zero.
EBADF: Connection has gone stale, or a device error occurred.
ENETUNREACH: Bad message buffer.
ELIBACC: Unable to locate render plugin for specified font.
ESRCH: Unable to locate render plugin type for specified id.

Examples:

PfDynamicUnload(): See PfDynamicLoad().

PfDynamicUnloadCx(): See the example for PfDynamicLoadCx().

Classification:

Photon

Safety:
Interrupt handler	No
Signal handler	No
Thread	No