NAME

HsiSendPP− transfer data from HSI parallel port to yapbus
HsiRecvPP− transfer data from yapbus to HSI parallel port

SYNOPSIS

#include <hsidefs.h>

int HsiSendPP(hsi, npxl, nlines, rcvaddr)
HSIDEV ∗hsi;
int npxl, nlines, rcvaddr;

int HsiRecvPP(hsi, npxl, nlines, rcvaddr)
HSIDEV ∗hsi;
int npxl, nlines, rcvaddr;

DESCRIPTION

HsiSendPP initiates a transfer of data from the parallel port to the Chap and returns immediately.  Prior to calling this routine, a Chap routine (for example, YSCopy) must be started to accept data from the HSI.  The Chap will receive nlines bursts of pixels, with npxl pixels in each burst.  npxl must be a multiple of 16 and must not exceed HSI_MAXNPXL (defined in hsidefs.h). 

HsiRecvPP initiates a transfer of data from the Chap to the HSI parallel port and returns immediately.  After calling this routine, a Chap routine must be started to send data to the HSI.  The Chap must send nlines bursts of pixels, with npxl pixels in each burst.  npxl must be a multiple of 16 and must not exceed HSI_MAXNPXL. 

In both cases, the flow of data is controlled by the external device connected to the parallel port.  The user program may call HsiSignalDone to receive a signal when the transfer completes, or HsiWaitDone to wait until the transfer completes (i.e., the specified quantity of data has been transfered to or received from the parallel port).  After the transfer is complete, HsiGetStatus should be called to discover if the transfer was successful. 

RETURN VALUE

HsiSendPP and HsiRecvPP return 0 to indicate success and −1 to indicate failure due to an invalid parameter. 

SEE ALSO

HsiGetStatus(3H), HsiOpen(3H), HsiSignal(3H), HsiWait(3H)

HSI Tutorial

Sun Release 4.1  —  Last change: