User manual

2.3.82 AcqrsD1_multiInstrDefine
Purpose
This function defines the combination of a number of digitizers connected by AS bus into a single
MultiInstrument. It is not applicable to AS bus 2 modules.
Parameters
Input
Name Type Description
instrumentList ViSession [ ] Array of 'instrumentID' of already initialized single
digitizers
nbrInstruments ViInt32 Number of digitizers in the 'instrumentList'
masterID ViSession 'instrumentID' of master digitizer
Output
Name Type Description
instrumentID ViSession Instrument identifier
Return Value
Name Type Description
status ViStatus Refer to Table 2-1 for error codes.
Discussion
You should refer to to the Programmer’s Guide section 3.2, Device Initialization, for a detailed
explanation on the initialization procedure.
The function returns the error code ACQIRIS_ERROR_MODULES_NOT_ON_SAME_BUS if all modules
in the instrumentList are not on the same bus.
It may also return the error codes ACQIRIS_ERROR_NOT_ENOUGH_DEVICES or
ACQIRIS_ERROR_NO_MASTER_DEVICE, when nbrInstruments is < 2 or the masterID is not one of
the values in the instrumentList.
This function should only be used if the choices of the automatic initialization function
AcqrsD1_multiInstrAutoDefine must be overridden. If the function executes successfully, the
instrumentID presented in the instrumentList cannot be used anymore, since they represent individual
digitizers that have become part of the new MultiInstrument, identified with newly returned instrumentID.
Please refer to the Programmer’s Guide section 3.2.8, Manual Definition of MultiInstruments for more
information.
Programmer’s Reference Manual Page 156 of 210