CompuScope SDK Manua.. - Egmont Instruments

gage_trigger_view_transfer_3
Syntax
C:
uInt32 GAGEAPI gage_trigger_view_transfer_3 (int16 channel, void far *buffer, int32 nsamples);
Visual BASIC:
This routine is currently not supported under Visual BASIC.
Remarks
gage_trigger_view_transfer_3 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 CompuScope PCI boards will use bus-mastering if available; otherwise this routine is the same as
gage_trigger_view_transfer.
The buffer must be at least two dwords longer than the required size to store nsample samples. The
calling program should typecast this buffer to the appropriate type before accessing the data.
The application does not need to interleave the data when the acquisition has been performed in single
channel mode, as is the case with gage_transfer_buffer, gage_trigger_view_transfer,
gage_transfer_buffer_2 and gage_trigger_view_transfer_2. These routines should be used for new
development when they are available.
Return Value
Returns an offset to the beginning of the dword-aligned buffer that the driver uses. The offset is the
difference between the buffer passed to the driver and the buffer the driver uses.
See also
gage_trigger_view_transfer and Appendix B: Comparison of Various Data Transfer Routines.
Examples
C:
offset = gage_trigger_view_transfer_3 (GAGE_CHAN_A, (uInt8 far *)(buffer), 512);
new_ptr = (uInt8 *)(buffer+offset);
first_value = new_ptr[0];
Examples
C:
gage_trigger_view_transfer_3 (GAGE_CHAN_A, (uInt8 far *)(buffer), 512);
CompuScope API Reference Manual
91