INT32S DRV_FAITransfer ( PTR_T DeviceHandle, PT_FAITransfer *lpFAITransfer );
Transfers data from FAI (Fast Analog Input) sampling buffer to user's buffer. If the buffer is “HalfReady” (checked with function DRV_FAICheck), then the data must be transferred (FAITransfer) in order to avoid being overwritten. Please sets property parameters to make sure that each data transferring copies one half buffer, low or high half buffer.
Some parameters, such as user's buffer (DataBuffer), data output type (DataType, Unsigned short/Float), start point to sampling buffer (start), data count (count) and overrun status (overrun), are saved in the PT_FAITransfer, structure pointed by the lpFAITransfer.
|
Name |
Direction |
Range |
Description |
|
DeviceHandle |
input |
default |
The pointer retrieved from the DRV_DeviceOpen which specifies the target device. |
|
lpFAITransfer |
input / output |
default |
The pointer to indicate the user-prepared structure PT_FAITransfer that stores user's buffer (void * DataBuffer), data type (INT16U DataType), start point to read sampling buffer (INT32U start), sampling count (INT32U count) and overrun status (INT16U * overrun). |
| 1. 0 | Successful. |
| 2. Other value | Please reference ErrorCodes |