Measurement Computing Data Acquisition Systems rev.10.4 - Manual (Page 115)

daqAdcTransferGetStat
Also See: daqAdcTransferSetBuffer,
daqAdcTransferStart,
daqAdcTransferStop, daqAdcSetDiskFile
Format
daqAdcTransferGetStat(handle, active, retCount)
Purpose
daqAdcTransferGetStat retrieves the current state of an acquisition transfer, and can be used to initiate
transfers to the disk.
Parameter Summary
Parameter Type Description
handle DaqHandleT Handle to the device from which ADC transfer status is to be retrieved
active PDWORD A pointer to the transfer-state flags in the form of a bit mask
retCount PDWORD A pointer to the total number of ADC scans acquired (or available) in
the current transfer
Parameter Values
handle: obtained from the daqOpen function
active: a valid pointer to a double word variable (4 bytes) in which the acqusition and transfer status flags
will be stored upon return of this function; see table below for flag values
retCount: a valid pointer to a long integer variable (4 bytes) in which the total number of scans transferred
will be stored (0 to scanCount) upon return of this function
Parameter Type Definitions
active
Definition Description
DaafAcqActive An acquisition is active; the trigger may or may not yet have occurred but the acquisition
has at least been armed
DaafAcqTriggered The acquisition has been triggered, and post-trigger data is now being collected
DaafTransferActive A buffer transfer is active; an acquisition may or may not be active but a buffer transfer
has been enabled
Returns
DerrNoError No error
Function Usage
Data Transfer Progress
The value that the retCount parameter returns depends upon the buffer management mode selected
(see daqAdcTransferSetBuffer function for more information on buffer allocation modes):
User Buffer Mode (DatmUserBuf) – The retCount parameter will return the total amount of data
written (in scans) to the user allocated buffer(s) during the duration of the acquisition. The following
diagram illustrates how retCount is determined:
Programmer’s Manual 908594 Daq API Command Reference 4.2-59