User manual

2.3.15 Acqrs_InitWithOptions
Purpose
Initializes an instrument with options.
Parameters
Input
Name Type Description
resourceName ViRsrc ASCII string which identifies the instrument to be
initialized. See discussion below.
IDQuery ViBoolean Currently ignored
resetDevice ViBoolean If set to 'TRUE', resets the instrument after
initialization.
optionsString ViString ASCII string that specifies options.
Syntax: "optionName=bool" where bool is TRUE (1)
or FALSE (0).
Currently three options are supported:
”CAL”: do calibration at initialization (default 1)
"DMA": use scatter-gather DMA for data transfers
(default 1).
"simulate": initialize a simulated device (default 0).
NOTE: optionsString is case insensitive.
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 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_INIT_STRING_INVALID when the initialization
string could not be interpreted.
Multiple options can be given; Separate the option=value pairs with ‘,’ characters.
Programmer’s Reference Manual Page 33 of 210