NAME
    SCI_Filter_unload - Unload a previously loaded filter

C Syntax
    #include <sci.h>
    int SCI_Filter_unload(int filter_id)

INPUT PARAMETERS
    filter_id
        The id of the filter to be unloaded (IN).

DESCRIPTION
    This subroutine is used to unload a previously loaded filter specifed by
    filter_id, if success, the termination handler defined in the filter will
    be called.

    Usually cleanup works can be performed in the termination handler.

    For more information, please refer to SCI's online documents.

EXAMPLE
        {
                int filter_id = 1;
                ...
                SCI_Filter_unload(filter_id);
        }

ERRORS
    All SCI routines return an error value.

    SCI_ERR_UNINTIALIZED
        Uninitialized SCI execution environment
    SCI_ERR_INVALID_CALLER
        Can only be called in the front end
    SCI_ERR_FILTER_PREDEFINED
        Can't unload predefined filter SCI_FILTER_NULL
    SCI_ERR_FILTER_ID
        Unknown filter id or the filter is not loaded previously
    SCI_ERR_NO_MEM
        Out of memory

SEE ALSO
    SCI_Filter_load(3)