VTI Instruments EX1629 - Vtex1629_Findinstr

www.vtiinstruments.com
EX1629 Command Set 123
vtex1629_findinstr
FUNCTION PROTOTYPE
ViStatus vtex1629_findinstr (ViPString instruments, ViInt32 maxinstr, ViPInt32 numinstr, ViInt32
timeout_secs);
FUNCTION PARAMETERS
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.
DATA ITEM RESET VALUE
Not applicable to this function.
DESCRIPTION
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.
EXAMPLE
#define MAX_INSTRUMENTS (500)
#define TIMEOUT (1000)
ViStatus status;
ViString instrumentIDs[MAX_INSTRUMENTS];
ViInt32 i, numberDiscovered;
…
…
status = vtex1629_findinstr (&instrumentIDs[0],
MAX_INSTRUMENTS,
&numberDiscovered,
TIMEOUT);
if (status < VI_SUCCESS)
{
<inform the user the API call failed>
} else {
for (i=0; i < numberDiscovered; i++)
{
<handle this instrument>
}
}