Daqadctransfergetstat – Measurement Computing Personal Daq rev.6.0 User Manual
Page 148

B-16 API Commands
Appendix B,
887095
Personal Daq 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 Also
daqAdcTransferSetBuffer, daqAdcTransferStart, daqAdcTransferStop
Program References
ADCEX1.C, FREQEX1.C, PULSEEX1.C, MULTEX1.C, DAQEX.FRM (VB), DAQEX.PAS (Delphi)
Used With
All devices
Description
daqAdcTransferGetStat
allows you to retrieve the current state of an 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)