beautypg.com

Daqadctransferbufdata, Format, Purpose – Measurement Computing Data Acquisition Systems rev.10.4 User Manual

Page 112: Parameter summary, Parameter values

background image

daqAdcTransferBufData

Also See: daqAdcTransferSetBuffer,

daqAdcTransferGetStat, daqSetTimeout

Format

daqAdcTransferBufData(handle, buf, scanCount, bufMask, retCount)

Purpose

daqAdcTransferBufData

requests a transfer of scanCount scans from the driver allocated acquisition

buffer (driver buffer) to the specified linear data retrieval buffer (buf). The driver buffer is configured with
the daqAdcTransferSetBuffer function.

Parameter Summary

Parameter Type

Description

handle DaqHandleT

Handle to the device from which the ADC buffer
should be retrieved

buf PWORD

Pointer to an application-supplied buffer in which to
place the buffered data

scanCount DWORD

Number of scans to retrieve from the acquisition buffer

bufMask DaqAdcBufferXferMask

A mask-defining operation depending on the current
state of the acquisition buffer

retCount PDWORD

A pointer to the total number of scans returned, if any

Parameter Values

handle:

obtained from the daqOpen function

buf:

must be a valid pointer to memory whose size is at least equal to:

[(scanCount) * (the channel count) * (the sample size, normally 2 bytes)]
scanCount:

valid values are 1 to length of the driver buffer (see daqAdcTransferSetBuffer

function)

bufMask:

see table below

retCount:

a valid pointer to a long integer variable (4 bytes) in which the total number of scans returned

(from 0 to scanCount) will be stored upon return of this function

Parameter Type Definitions:

bufMask-(DaqAdcBufferXferMask)

Definition

Description

DabtmOldest

Retrieve oldest unread scans from driver buffer

DabtmNewest

Retrieve newest unread scans from driver buffer

DabtmWait

Wait for requested amount of data to become available

DabtmRetAvail

Return immediately with whatever data is available

DabtmNoWait

Return immediately, only retrieve if requested data is available

DabtmRetNotDone

Return immediately if still active

4.2-56 Daq API Command Reference

988594

Programmer’s Manual