CompuScope SDK Manua.. - Egmont Instruments

gage_mem_read_dual
Syntax
C:
int16 GAGEAPI gage_mem_read_dual (int16 channel, int32 location);
Visual BASIC:
Function gage_mem_read_dual (ByVal channel As Integer, ByVal location As Long) As Integer
Remarks
gage_mem_read_dual reads one sample out of CompuScope memory 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.
channel can be one of the constants GAGE_CHAN_A or GAGE_CHAN_B.
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 gage_mem_read_dual, 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 or channel B is returned as an
unsigned integer (0 - 255) for 8 bit CompuScopes, as 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_single, gage_mem_read_chan_a, gage_mem_read_chan_b, gage_calculate_addresses and
Appendix: Comparison of Various Data Transfer Routines.
Examples
C:
data = gage_mem_read_dual (GAGE_CHAN_A, address);
Visual BASIC:
data = gage_mem_read_dual (GAGE_CHAN_A, address)
CompuScope API Reference Manual 74