CompuScope SDK Manua.. - Egmont Instruments

gage_driver_initialize
Syntax
C:
int16 GAGEAPI gage_driver_initialize (uInt16 far *records, uInt16 memory);
Visual BASIC:
function gage_driver_initialize (records As Integer, ByVal memory As Integer) As Integer
Remarks
The gage_driver_initialize routine fully configures each CompuScope found in the system and initializes
the drivers. From then on, a call to gage_select_board will be required to access any CompuScope.
Below is a detailed description of the values returned by gage_driver_initialize. These values are used
internally by other CompuScope API subroutines. Understanding these values is not necessary for most
users who need only call gage_driver_initialize once and move on.
The records parameter is a word (2 byte) array, which must be provided by the calling program. Before
the gage_driver_initialize routine is called, the first half of the records variable must have been
previously initialized to contain the segment / index for each CompuScope in the system. This is best done
with a call to the gage_read_config_file routine. Also before the gage_driver_initialize routine is called,
the second half of the records variable should contain all zeros. The array gage_board_location has been
made available within the drivers to be passed as the records parameter and is
GAGE_B_L_BUFFER_SIZE words long.
CompuScope gage_board_location (defined in GAGE_DRV.H file) array “pseudo structure”
GAGE_B_L_ELEMENT_SIZE
GAGE_B_L_STATUS_SIZE
array index: 0 1 2 3 ... 30 31 32 33 34 35 ... 62 63
meaning: S1 I1 S2 I2 ... S16 I16 B1 E1 B2 E2 ... B16 E16
GAGE_B_L_STATUS_START
where: Sx = segment for CompuScope x,
Ix = index for CompuScope x,
Bx = returned board type for CompuScope x,
Ex = returned status error for CompuScope x.
/* CompuScope definitions for gage_board_location sizing. */
#define GAGE_B_L_MAX_CARDS 16
#define GAGE_B_L_SIZEOF_ELEMENT 2
#define GAGE_B_L_ELEMENT_SIZE 2
#define GAGE_B_L_STATUS_SIZE 2
#define GAGE_B_L_STATUS_START (GAGE_B_L_MAX_CARDS *
GAGE_B_L_ELEMENT_SIZE)
CompuScope API Reference Manual 28