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
Concurrency Mode
Supported Board(s)
Supported Operating
System(s)
AR_CONC_NONE
all CEI-x20 boards
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.
Syntax
Description
Artisan Technology Group - Quality Instrumentation ... Guaranteed | (888) 88-SOURCE | www.artisantg.com