IBLN
Board-Level
Purpose
Check for the presence of a device on the bus.
Format
C
|
unsigned long ibln (int ud, int pad, int sad, short *listen)
|
Visual Basic
|
CALL ibln (ud%, pad%, sad%, listen%)
|
or
|
status% = illn (ud%, pad%, sad%, listen%)
|
ibln pad sad
Input
|
ud
|
Board descriptor |
|
pad
|
The primary GPIB address of the device |
|
sad
|
The secondary GPIB address of the device |
Output
|
listen
|
Indicates if a device is present or not |
| Function Return |
The value of Ibsta
|
Description
ibln determines whether there is a listening device at the GPIB address designated by the pad and sad parameters. The bus associated with the board is tested for Listeners. If a Listener is detected, a non-zero value is returned in listen. If no Listener is found, zero is returned.
The pad parameter can be any valid primary address (a value between 0 and 30). The sad parameter can be any valid secondary address (a value between 96 to 126), or one of the constants NO_SAD or ALL_SAD. The constant NO_SAD designates that no secondary address is to be tested (only a primary address is tested). The constant ALL_SAD designates that all secondary addresses are to be tested.
Possible Errors
|
EARG
|
Either the pad or sad argument is invalid. |
|
ECIC
|
The access board is not CIC. |
|
EDVR
|
The NI-488.2 driver is either configured incorrectly or is not properly installed. |
|
EHDL
|
ud is invalid or 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. |