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


NAME
    GT_PostFilterIMsg -- Return the unfiltered message after
        GT_FilterIMsg() was called, and clean up. (V36)

SYNOPSIS
    imsg = GT_PostFilterIMsg(modimsg)
    D0                       A1

    struct IntuiMessage *GT_PostFilterIMsg(struct IntuiMessage *);

FUNCTION
    NOTE WELL:  Extremely few programs will actually need this function.
    You almost certainly should be using GT_GetIMsg() and GT_ReplyIMsg()
    only, and not GT_FilterIMsg() and GT_PostFilterIMsg().

    Performs any clean-up necessitated by a previous call to
    GT_FilterIMsg().  The original IntuiMessage is now yours to handle.
    Do not interpret the fields of the original IntuiMessage, but
    rather use only the one you got from GT_FilterIMsg().  You
    may only do message related things at this point, such as queueing
    it up or replying it.  Since you got the message with
    exec.library/GetMsg(), your responsibilities do include replying
    it with exec.library/ReplyMsg(). This function may be safely
    called with a NULL parameter.

INPUTS
    modimsg - A modified IntuiMessage obtained with GT_FilterIMsg().

RESULT
    imsg - A pointer to the original IntuiMessage, if GT_FilterIMsg()
        returned non-NULL.

EXAMPLE

NOTES
    Be sure to use exec.library/ReplyMsg() on the original IntuiMessage
    you obtained with GetMsg(), (which is the what you passed to
    GT_FilterIMsg()), and not on the parameter of this function.

BUGS

SEE ALSO
    GT_FilterIMsg()