[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


    NAME
        ReleaseInfoA -- Release data obtained with obtaininfoa
        ReleaseInfo -- varargs form of ReleaseInfoA

    SYNOPSIS
        error = ReleaseInfoA(engineHandle, tagList)
                             A0            A1

        ULONG ReleaseInfoA(struct glyphengine *, struct tagitem *);

        error = ReleaseInfo(engineHandle, firstTag, ...)

        ULONG ReleaseInfo(struct glyphengine *, tag, ...);

    FUNCTION
        This function releases the data obtained with obtaininfoa.
        Data associated with tags that are not indirect, i.e. for which
        OT_Indirect is not set, need not be released, but it is not an
        error to do so.  Released data may be immediately freed or may
        become a candidate to be expunged from memory when the system
        reaches a low memory condition, depending on the library's
        internal implementation.

        Each ReleaseInfoA tag item must be associated with a prior
        obtaininfoa.

    INPUTS
        engineHandle -- the handle acquired via openengine.
        tagList -- a tagList containing OT_ tags valid for inquiry
                paired with the data previously acquired for them with
                obtaininfoa.  null pointers quietly accepted and
                ignored for indirect data.

    RESULT
        This function has no result.  The only error that can occur is
        when the Obtain and Release pairs are mismatched: the
        application is assumed not to do that.

    EXAMPLE
            ULONG pointSize;
            struct glyphmap *glyph;
            ...
            error = ObtainInfo(EngineHandle, OT_Glyph, &glyph, TAG_DONE);
            ...
            ReleaseInfo(EngineHandle, OT_Glyph, glyph, TAG_DONE);

    SEE ALSO
        ReleaseInfoA(), diskfont/diskfonttag.h, diskfont/oterrors.h