Program Interface Library AR_SET_PRELOAD_CONFIG
CEI-100/CEI-200/CEI-x20 User’s Manual 138
AR_SET_PRELOAD_CONFIG
CEI_INT16 ar_set_preload_config (CEI_INT16 board, CEI_INT16 item,
CEI_UINT32 value);
Call this routine before calling AR_LOADSLV to update the value of a
particular load configuration setting. This routine should not be called
after the calling process has executed AR_LOADSLV.
Only the CEI-520/520A/620/820/820TX enhanced API supports this
function.
If 'item' is ARU_CONCURRENCY_MODE, the 'value' parameter
specifies the board concurrency mode. One of three modes may be
selected: AR_CONC_NONE, AR_CONC_MULTITHRD, or
AR_CONC_MULTIPROC. Note that some modes are only supported on
certain boards and operating systems (see table below).
Table 46. Supported Concurrency Modes
Supported Operating
System(s)
all operating systems
supported by the CEI-x20 API
AR_CONC_MULTITHRD or
AR_CONC_MULTIPROC
CEI-520/520A, CEI-620,
CEI-820
Windows XP/Vista/7/Server
2008/8.0/8.1/Server 2012/10,
Red Hat Linux Ent 4 (kernels
2.6.17.13, 2.6.18, 2.6.20.14,
2.6.22.2, and 2.6.22.19 only)
The default concurrency mode, AR_CONC_NONE, provides no multi-
thread protection and no multi-process support. The user application must
ensure that at most one thread is calling into the API at any given time, and
only a single process may interface with a particular board.
If AR_CONC_MULTITHRD concurrency mode is selected, thread
protection is provided internally within the API. The user application may
call into the API from multiple threads, but all threads must belong to a
single process. The main user application thread should initialize the
board with a call to AR_LOADSLV before other threads attempt to call
into the API.
If AR_CONC_MULTIPROC concurrency mode is selected, thread
protection is provided internally within the API and multiple processes
may interface with a single board. If any process requests multi-process
mode, all other processes must also request multi-process mode.
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com