SendSetup

NI-488.2

SendSetup


Purpose

Set up devices to receive data in preparation for SendDataBytes.

Format

C

void SendSetup (int boardID, const Addr4882_t *addrlist)

Visual Basic

CALL SendSetup (boardID%, addrlist%())

Interactive Control (Usage Notes)

Send addrlist

Input

boardID The interface number
addrlist A list of device addresses that is terminated by NOADDR

Description

SendSetup makes the devices described by addrlist listen-active and makes the interface talk-active. This call is usually followed by SendDataBytes to actually transfer data from the interface to the devices. SendSetup is particularly useful to set up the addressing before making multiple calls to SendDataBytes; it eliminates the need to readdress the devices for every block of data.

Possible Errors

EARG Either an invalid address appears in addrlist or the addrlist is empty; Ibcnt is the index of the first invalid address in the addrlist array.
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.