User manual

Error code Hex value Decimal value
VI_SUCCESS
0 0
VI_ERROR_PARAMETER1
BFFC0001 -1074003967
VI_ERROR_PARAMETER2
BFFC0002 -1074003966
VI_ERROR_PARAMETER3
BFFC0003 -1074003965
VI_ERROR_PARAMETER4
BFFC0004 -1074003964
VI_ERROR_PARAMETER5
BFFC0005 -1074003963
VI_ERROR_PARAMETER6
BFFC0006 -1074003962
VI_ERROR_PARAMETER7
BFFC0007 -1074003961
VI_ERROR_PARAMETER8
BFFC0008 -1074003960
VI_ERROR_FAIL_ID_QUERY
BFFC0011 -1074003951
VI_ERROR_INV_RESPONSE
BFFC0012 -1074003950
Table 2-2 VXIplug&play Error Codes
If important parameters supplied by the user (e.g. an instrumentID) are found to be invalid, most functions do not
execute and return an error code of the type VI_ERROR_PARAMETERi, where i = 1, 2,... corresponds to the
argument number.
If the user attempts (with a function AcqrsD1_configXXXX) to set a digitizer parameter to a value outside of its
acceptable range, the function typically adapts the parameter to the closest allowed value and returns
ACQIRIS_WARN_SETUP_ADAPTED. The digitizer parameters that are actually in use can be retrieved with the
query functions AcqrsD1_getXXXX.
Data are always returned through pointers to user-allocated variables or arrays.
Some parameters are labeled "Currently ignored". It is recommended to supply the value "0" (ViInt32) or "0.0"
(ViReal64) in order to be compatible with future products that may offer additional functionality.
2.2. API Function classification
The API has been split into three families:
 Acqrs Generic functions - AqBx - these can be used for all Acqiris Instruments
 AcqrsD1 Digitizer functions - AqDx - to be used for Digitizers and Analyzers
 AcqrsT3 Time-to-Digital Converter functions - AqTx - to be used for the family of Time-to-Digital
Converters
All of these functions are still contained in one library called AqDrv4. However, there are separate files for the
headers and the LabWindows front-panel interface. The LabView interface is also split into the three corresponding
AqXX parts. The AcqrsD1 section includes redundant copies of the generic functions so that backward calling
compatibility can be maintained for existing code.
Visual Basic support will be limited to the Generic and AcqrsD1 families. Time-to-Digital Converters are not
supported.
AcqirisInterface.h is the header file for these functions:
Generic Initialization Functions
Function Name
Number of Physical Instruments
Acqrs_getNbrInstruments
Initialization
Acqrs_init
Initialization with Options
Acqrs_InitWithOptions
Simulation Options
Acqrs_setSimulationOptions
Generic Calibration Functions
Calibrate Instrument
Acqrs_calibrate
Calibrate Instrument Extended
Acqrs_calibrateEx
Generic Query Functions
Instrument Basic Data
Acqrs_getInstrumentData
Instrument Information
Acqrs_getInstrumentInfo
Number of Channels
Acqrs_getNbrChannels
Programmer’s Reference Manual Page 10 of 210