FindLstn
Purpose
Find listening devices on the GPIB.
Format
C
|
void FindLstn (int boardID, const Addr4882_t *padlist, short *resultlist, size_t limit)
|
Visual Basic
|
CALL FindLstn (boardID%, padlist%(), resultlist%(), limit%)
|
FindLstn padlist limit
Input
|
boardID
|
The interface number |
|
padlist
|
A list of primary addresses that is terminated by NOADDR
|
|
limit
|
Total number of entries that can be placed in resultlist
|
Output
|
resultlist
|
Addresses of all listening devices found by FindLstn are placed in this array |
Description
FindLstn tests all of the primary addresses in padlist as follows: If a device is present at a primary address given in padlist, the primary address is stored in resultlist. Otherwise, all secondary addresses of the primary address are tested, and the addresses of any devices found are stored in resultlist. No more than limit addresses are stored in resultlist. Ibcnt contains the actual number of addresses stored in resultlist.
Possible Errors
|
EARG
|
An invalid primary address appears in padlist; Ibcnt is the index of the first invalid address in the padlist 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. |
|
ETAB
|
The number of devices found on the GPIB exceed limit. |