beautypg.com

Daqadctransfergetstat – Measurement Computing Personal Daq rev.6.0 User Manual

Page 148

background image

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)

This manual is related to the following products: