SendList
Purpose
Send data bytes to multiple GPIB devices.
Format
C
|
void SendList (int boardID, const Addr4882_t *addrlist, const void *buffer, size_t count, int eotmode)
|
Visual Basic
|
CALL SendList (boardID%, addrlist%(), buffer$, eotmode%)
|
|
SendList addrlist buffer eotmode
|
Input
|
boardID
|
The interface number |
|
addrlist
|
A list of device addresses to send data |
|
buffer
|
The data bytes to be sent |
|
count
|
Number of bytes transmitted |
|
eotmode
|
The data termination mode: DABend, NULLend, or NLend
|
Description
SendList addresses the devices described by addrlist to listen and the interface to talk. Then, count bytes from buffer are sent to the devices. The last byte is sent with the EOI line asserted if eotmode is DABend. The last byte is sent without the EOI line asserted if eotmode is NULLend. If eotmode is NLend, a new line character ('\n') is sent with the EOI line asserted after the last byte. The actual number of bytes transferred is returned in the global function, Ibcnt.
Possible Errors
|
EABO
|
The I/O timeout period expired before all of the bytes were sent. |
|
EARG
|
Either an invalid address appears in addrlist or the addrlist is empty (Ibcnt is the index of the first invalid address), or the eotmode parameter is invalid. The eotmode parameter can only be DABend, NULLend, or NLend. If the buffer is empty, an eotmode of DABend is disallowed. |
|
EBUS
|
No devices are connected to the GPIB. |
|
ECIC
|
The interface is not the Controller-In-Charge; see SendIFC. |
|
EDVR
|
The NI-488.2 driver is either configured incorrectly or is not properly installed. |
|
EHDL
|
boardID is out of range. |
|
ELCK
|
The requested operation could not be performed because of an existing lock by another process. |
|
ENEB
|
The interface is not installed or is not properly configured. |
|
EOIP
|
Asynchronous I/O is in progress. |