cnv_open(3)                         CLIX                         cnv_open(3)



  NAME

    cnv_open - Opens a Convolution Filter (CNV) channel

  LIBRARY

    Intergraph Device Library (libix.a)

  SYNOPSIS

    #include <sys/xio/xerr.h>

    int cnv_open( channel
      int *base );

  PARAMETERS

    channel   An integer representing a channel

    base      The virtual base address of the CNV board

  DESCRIPTION

    The cnv_open() function opens the specified Convolution Filter (CNV)
    channel.  Only one process can open a CNV channel at a time.  Each CNV
    board in the system is represented by a channel number so that channel 0
    references the CNV board with the lowest Shared Resource (SR) Bus slot
    number for all CNVs.  If the call is successful, base will contain the
    virtual base address of the specified CNV board.  All convolution
    parameters are available to the calling process through this mapping.

  RETURN VALUES

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

  ERRORS

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

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

    [CNV_REDUNDANT_REQ]
           The specified channel is currently opened by this process.

    [CNV_CHANNEL_INVALID]
           The specified channel is beyond the maximum allowed.

    [CNV_CHANNEL_NOT_FOUND]



  2/94 - Intergraph Corporation                                              1

  cnv_open(3)                         CLIX                         cnv_open(3)



           The specified channel is not in the system.

    [CNV_CHANNEL_BUSY]
           The specified channel is currently opened by another process.

  RELATED INFORMATION

    Files:  xcnv(7)














































  2                                              Intergraph Corporation - 2/94