Measurement Computing TempBook rev.3.0 - Manual (Page 141)

TempBook User’s Manual daqCommand Reference (Enhanced API) 11-17
daqAdcTransferGetStat
DLL Function daqAdcTransferGetStat(DaqHandleT handle, PDWORD active, PDWORD retCount);
C daqAdcTransferGetStat(DaqHandleT handle, PDWORD active, PDWORD retCount);
Visual BASIC VBdaqAdcTransferGetStat&(ByVal handle&, active&, retCount&)
Delphi daqAdcTransferGetStat( handle:DaqHandleT; var active:DWORD; var retCount:DWORD )
Parameters
handle Handle to the device for which ADC transfer status is to be retrieved
active A pointer to the transfer-state flags in the form of a bit mask
retCount A pointer to the total number of ADC scans acquired (or available) in the current transfer
Returns DerrNoError - No error (also, refer to API Error Codes on page 11-39)
See Also daqAdcTransferSetBuffer, daqAdcTransferStart, daqAdcTransferStop
Program References ADCEX1.C, DACEX1.C, DYN32ENH.C, DAQEX.FRM (VB), ADCEX.PAS (Delphi)
Used With All devices
daqAdcTransferGetStat allows you to retrieve the current state of an ADC acquisition
transfer.
The active parameter will indicate the current state of the transfer in the form of a bit mask. Refer
to the ADC Acquisition/Transfer Active Flag Definitions (in the ADC Miscellaneous Definitions
table) for valid bit-mask states.
The retCount parameter will return the total number of scans acquired in the current transfer if
the transfer is in user-allocated buffer mode or will return the total number of unread scans in the
acquisition buffer if the transfer is in driver-allocated buffer mode. Refer to the
daqAdcTransferSetBuffer
function for more information on buffer allocation modes.
The transfer state and return count values will continue to be updated until any of the following
occurs:
•
the transfer count is satisfied
•
the transfer is stopped (daqAdcStopTransfer)
•
the acquisition is disarmed (daqDisarm)