Daqadctransfergetstat – Measurement Computing WaveBook rev.3.0 User Manual
Page 212

D-16 daqX API - Command Reference,
6-24-99
WaveBook User’s Manual
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 )
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
Parameters
retCount
A pointer to the total number of ADC scans acquired (or available) in the current transfer
Returns
DerrNoError
No error (see the API Error Codes table at the end of this chapter).
See Also
daqAdcTransferSetBuffer, daqAdcTransferStart, daqAdcTransferStop
Program References
ADCEX1.C, DACEX1.C, DYN32ENH.C, DAQEX.FRM (VB), ADCEX.PAS (Delphi)
Used With
All devices
Description
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), or the acquisition is disarmed (daqDisarm).