CompuScope SDK Manua.. - Egmont Instruments

gage_transfer_buffer_2
Syntax
C:
void far* GAGEAPI gage_transfer_buffer_2 (int32 ta, int16 channel, void far *buffer, int32 nsamples);
Visual BASIC:
This routine is currently not supported under Visual BASIC.
Remarks
gage_transfer_buffer_2 is used to copy nsamples points from the specified channel to the supplied
buffer beginning from address ta. The channel can be either GAGE_CHAN_A or GAGE_CHAN_B. The
relevant addresses can be obtained by calling gage_calculate_addresses routine. The buffer should be
typecast to the appropriate size before accessing it. The CompuScope PCI boards will use bus-mastering if
available, otherwise this routine is the same as gage_transfer_buffer.
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 that points 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. The even addresses will be from channel A and the
odd addresses will be from channel B. The data must then be interleaved by the application when using
gage_transfer_buffer, gage_trigger_view_transfer, gage_transfer_buffer_2 and
gage_trigger_view_transfer_2 routines.
Please see the Sample Programs 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_transfer_buffer, gage_transfer_buffer_3 and Appendix B: Comparison of Various Data Transfer
Routines.
Examples
C:
ptr = gage_transfer_buffer_2(current_address, GAGE_CHAN_A, (uInt8 far *)(buffer), 512);
first_value = ptr[0];
CompuScope API Reference Manual
85