Vtex1629_Findinstr - VTI Instruments EX1629 User Manual

F P
UNCTION ROTOTYPE
ViStatus vtex1629_findinstr (ViPString instruments, ViInt32 maxinstr, ViPInt32 numinstr, ViInt32
timeout_secs);
F P
UNCTION ARAMETERS
instruments = a return pointer to an array of strings, each of which contains the Plug&Play compliant resource
descriptor of an EX1629 found on the network. (Example descriptor: "TCPIP::192.168.1.1::INSTR".)
maxinstr = an integer input value that specifies the maximum number of instruments to return.
numinstr = a returned integer indicating the number of instruments found.
timeout_secs = an integer input value, in seconds, indicating the amount of time to search before timing out.
D I R V
ATA TEM ESET ALUE
Not applicable to this function.
D
ESCRIPTION
This function scans the LAN for available EX1629 instruments and returns their resource descriptors, including IP
addresses, as an array of strings, suitable for use with the function.
E
XAMPLE
#define MAX_INSTRUMENTS (500)
#define TIMEOUT (1000)
ViStatus status;
ViString instrumentIDs[MAX_INSTRUMENTS];
ViInt32 i, numberDiscovered;
...
...
status = vtex1629_findinstr (&instrumentIDs[0],
if (status < VI_SUCCESS)
{
<inform the user the API call failed>
} else {
for (i=0; i < numberDiscovered; i++)
{
<handle this instrument>
}
}
EX1629 Command Set

vtex1629_findinstr

MAX_INSTRUMENTS,
&numberDiscovered,
TIMEOUT);
www.vtiinstruments.com
123