fpe_cancel_dma(3)                   CLIX                   fpe_cancel_dma(3)



  NAME

    fpe_cancel_dma - Cancels a write request to a Floating Point Engine (FPE)
    coprocessor

  LIBRARY

    Intergraph Device Library (libix.a)

  SYNOPSIS

    #include <sys/xio/xerr.h>

    int fpe_cancel_dma(
      int fpeno );

  PARAMETERS

    fpeno   A floating-point engine number

  DESCRIPTION

    The fpe_cancel_dma() function stops the active transfer to a Floating-
    Point Engine (FPE), and aborts transfers waiting to be started.  The fpeno
    parameter specifies the number of the FPE obtained by fpe_coproc_alloc().

  RETURN VALUES

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

  ERRORS

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

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

    [FPE_NOT_PRESENT]
           The value of fpeno specifies an FPE that is not in the system.

    [FPE_NOT_OWNER]
           The value of fpeno specifies an FPE that is not currently allocated
           by the process.

  RELATED INFORMATION

    Functions:  fpe_coproc_alloc(3), fpe_write_dma(3)

    Files: xfpe(7)



  2/94 - Intergraph Corporation                                              1