fg_dealloc(3)                       CLIX                       fg_dealloc(3)



  NAME

    fg_dealloc - Deallocates a frame grabber

  LIBRARY

    Intergraph Device Library (libix.a

  SYNOPSIS

    #include <sys/xio/xerr.h>

    int fg_dealloc(
      int fgno );

  PARAMETERS

    fgno   The frame grabber location on the Shared Resource (SR) Bus.

  DESCRIPTION

    The fg_dealloc() function deallocates a frame grabber.  Any further
    reference to the frame grabber is disallowed.  In addition, the frame
    buffer memory is unmapped from the calling process.

    The fgno parameter specifies the frame grabber location on the Shared
    Resource (SR) Bus.  The frame grabber in the lowest SR Bus slot will be
    addressed by 0.

  RETURN VALUES

    Upon successful completion, a value of 0 is returned.  Otherwise, one of
    the following failure codes is returned.

  ERRORS

    The fg_dealloc() function will fail if one of the following is true:

    [XIO_FAILURE]
           The system does not contain the driver needed to support this
           request.

    [FG_NOT_OWNER]
           The specified frame grabber was not allocated by the calling
           process.

  RELATED INFORMATION

    Functions:  fg_alloc(3)





  2/94 - Intergraph Corporation                                              1