CompuScope SDK Manua.. - Egmont Instruments

gage_mem_read_chan_a
Syntax
C:
int16 GAGEAPI gage_mem_read_chan_a (int32 location);
Visual BASIC:
Function gage_mem_read_chan_a (ByVal location As Long) As Integer
Remarks
gage_mem_read_chan_a reads one sample out of the CompuScope memory for channel A in dual
channel mode and returns it as an integer. It is usually used in a loop to retrieve data from a range of
addresses from a CompuScope board.
location is an address in the CompuScope memory and usually starts at the trigger address. It can precede
and/or follow the trigger address as set by the current trigger depth.
The gage_calculate_addresses routine is very useful for determining the valid addresses and should be
used instead of directly invoking the gage_trigger_address routine for future compatibility with the
CompuScope drivers.
When using the gage_mem_read_chan_a routine, access to the CompuScope memory must be obtained
by calling gage_need_ram(1) beforehand, and released by calling gage_need_ram(0) when finished.
Return Value
The byte (or integer) corresponding to the specified location for channel A is returned as an unsigned
integer (0 - 255) for 8 bit CompuScopes, a signed 12 bit integer (-2048 - 2047) for the 12 bit CompuScopes
and a signed 16 bit integer (-32768 to 32767) for the 16 bit CompuScopes.
See also
gage_mem_read_chan_b, gage_mem_read_dual, gage_mem_read_single, gage_need_ram,
gage_calculate_addresses and Appendix: Comparison of Various Data Transfer Routines.
Examples
C:
data = gage_mem_read_chan_a (address);
Visual BASIC:
data = gage_mem_read_chan_a (address)
CompuScope API Reference Manual 72