CompuScope SDK Manua.. - Egmont Instruments

#define GAGE_B_L_STATUS_START (GAGE_B_L_MAX_CARDS *
GAGE_B_L_ELEMENT_SIZE)
#define GAGE_B_L_BUFFER_SIZE (GAGE_B_L_MAX_CARDS *
(GAGE_B_L_ELEMENT_SIZE +
GAGE_B_L_STATUS_SIZE))
The format of the array is: first GAGE_B_L_STATUS_START words are for the CompuScope segment
and index values, each pair occupying GAGE_B_L_ELEMENT_SIZE words, for each of the possible
GAGE_B_L_MAX_CARDS boards. A status field is provided for each potential CompuScope location
that is GAGE_B_L_STATUS_SIZE words in length. The values for the status fields are initialized to 0 by
gage_get _config_filename. The status fields are updated by the gage_driver_initialize routine, whose
description explains their meaning.
Return Value
If the return value is greater than 0, it represents the number of records initialized.
If the number is less than zero, it corresponds to the error encountered. The errors are:
-1 file does not exist.
-2 file cannot be opened.
-3 file size cannot be determined.
-4 file size module four is not zero.
-5 file size indicates that more boards than the driver supports are present.
-6 file cannot be read successfully.
-7 file cannot be closed.
(0 is reserved for future use.)
See also
gage_driver_initialize and gage_get_config_filename
Examples
C:
expected = gage_read_config_file ((char far*)("GAGESCOP.INC"),
(uInt16 far*)(&gage_board_location));
Visual BASIC:
expected = gage_read_config_file (board_loc_file, gage_board_location (0))
CompuScope API Reference Manual 46