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

Interactive Control (Usage Notes)

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.