CompuScope SDK Manua.. - Egmont Instruments
CompuScope SDK Manua.. - Egmont Instruments
CompuScope SDK Manua.. - Egmont Instruments
Create successful ePaper yourself
Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.
gage_board_type_size_to_text<br />
Syntax<br />
C:<br />
LPSTR GAGEAPI gage_board_type_size_to_text (LPSTR string, uInt32 string_size, uInt32 action,<br />
uInt32 board, uInt32 far *bt, uInt32 far *eeopt,<br />
uInt32 far *ver, uInt32 far *max_mem);<br />
Remarks<br />
The gage_board_type_size_to_text routine is used to convert the board type parameter, returned by the<br />
drivers, into a text string that indicates the corresponding <strong>CompuScope</strong> model and/or memory size.<br />
The parameter string is a pointer to the string into which the <strong>CompuScope</strong> name will be returned by the<br />
routine. string_size is the size of the string pointed to by string.<br />
action can be one of the following constants defined in GAGE_DRV.H file:-<br />
GAGE_GBTSTT_BOARD<br />
GAGE_GBTSTT_MEMORY<br />
GAGE_GBTSTT_BOTH<br />
GAGE_GBTSTT_LONG_NAME<br />
GAGE_GBTSTT_ALL_UPPER_CASE<br />
0x01<br />
0x02<br />
0x03<br />
0x04<br />
0x08<br />
These constants determine in which format the string is returned. The constants can be ‘ORed’ together in<br />
order to request, say, <strong>CompuScope</strong>’s LONG_NAME in ALL_UPPER_CASE..<br />
board is the <strong>CompuScope</strong> board number from which information is to be requested (referred to as the<br />
“currently selected <strong>CompuScope</strong>”). If this parameter is 0 then the installed hardware is ignored and the<br />
returned string contents are determined by the following four parameters.<br />
*bt returns the type of the currently selected <strong>CompuScope</strong>. This will be a combination of predefined<br />
constants GAGE_ASSUME_XXXXX, where XXXXX is a board type. Board type constants are defined in<br />
GAGE_DRV.H file.<br />
*eeopt returns the available eeprom options for the currently selected <strong>CompuScope</strong>. The options are<br />
represented by one or more constants “ORed” together. The available constants are defined in EEPROM.H<br />
*ver returns the hardware version of the currently selected <strong>CompuScope</strong>.<br />
*max_mem returns the size of the memory on the currently selected <strong>CompuScope</strong>.<br />
If *bt, *eeopt, *ver and *max_mem values are NULL, the routine will fill them.<br />
Return Value<br />
Returns the pointer to the string with above-mentioned parameters.<br />
See Also: gage_support_to_text<br />
Examples C: gage_board_type_size_to_text (str, sizeof(str), 1L, 1,NULL, NULL, NULL, NULL);<br />
<strong>CompuScope</strong> API Reference <strong>Manua</strong>l<br />
17