23.11.2014 Views

CompuScope SDK Manua.. - Egmont Instruments

CompuScope SDK Manua.. - Egmont Instruments

CompuScope SDK Manua.. - Egmont Instruments

SHOW MORE
SHOW LESS

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

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!