CompuScope SDK Manua.. - Egmont Instruments

gage_trigger_view_transfer_2
Syntax
C:
void far* GAGEAPI gage_trigger_view_transfer_2 (int16 channel, void far *buffer, int32 nsamples);
Visual BASIC:
This routine is currently not supported under Visual BASIC.
Remarks
gage_trigger_view_transfer_2 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 calling program should typecast this buffer to the appropriate type before accessing the data.
Because bus-mastering requires the buffer to be dword-aligned, the driver may have to change its starting
address. The return value is a pointer to where the actual data begins. The difference between the buffer
address passed to the routine and the one returned will be 0, 1, 2 or 3 addresses.
Note: The buffer that the calling program allocates should be 4 samples larger than the requested size.
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 Program section in the CompuScope SDK Manual for further details.
Return Value
Returns a pointer that points to where the actual data begins.
See also
gage_trigger_view_transfer and Appendix B: Comparison of Various Data Transfer Routines.
Examples
C:
ptr = gage_trigger_view_transfer_2 (GAGE_CHAN_A, (uInt8 far *)(buffer), 512);
first_value = ptr[0];
CompuScope API Reference Manual 90