CompuScope SDK Manua.. - Egmont Instruments

gage_trigger_view_transfer
Syntax
C:
void GAGEAPI gage_trigger_view_transfer (int16 channel, uInt8 far *buffer, int16 nsamples);
Visual BASIC:
Sub gage_trigger_view_transfer (ByVal channel As Integer, buffer(0) As Integer,
ByVal nsamples As Integer)
Remarks
gage_trigger_view_transfer is used to copy nsample points of the CompuScope memory space, from the
channel specified in the parameter channel to the supplied buffer array buffer starting with the trigger
address of the most recent data capture. The starting point of the transferred data can be changed, by using
gage_set_trigger_view_offset. The default starting point is the trigger address.
For PCI (CP500) CompuScopes, there is no intrinsic limitation on the amount of data that can be
transferred at a time by gage_trigger_view_transfer. Please note, however, that for ISA CompuScopes, a
maximum of 4K samples may be transferred at a time. For 8-bit ISA CompuScopes, the sample size is 1
byte, so 4K samples equals 4K bytes. The 12 bit and 16 bit ISA CompuScopes use integer samples,
therefore 4K samples equals 4K integers.
For all CompuScope boards with two channels, single channel mode uses both of the channels. The
captured data must be transferred one channel at a time and put together by the application program. The
even addresses will be from channel A and the odd addresses will be from channel B. Please see the
Sample Programs section in the CompuScope SDK Manual for further details.
Return Value
None.
See also
Appendix: Comparison of Various Data Transfer Routines
Examples
C:
gage_trigger_view_transfer (GAGE_CHAN_A, (uInt8 far *)(buffer), 512);
Visual BASIC:
Call gage_trigger_view_transfer (GAGE_CHAN_A, buffer(0), 512)
CompuScope API Reference Manual
89