SendList

NI-488.2

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%)

Interactive Control (Usage Notes)

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.