beautypg.com

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

Page 118: Parameter summary, Parameter values, Parameter type definitions transfermask, Returns

background image

daqAdcTransferSetBuffer

Also See: daqAdcTransferStart, daqAdcTransferStop,

daqAdcTransferGetStat, daqAdcSetAcq,

daqAdcTransferBufData

Format

daqAdcTransferSetBuffer(handle, buf, scanCount, transferMask)

Purpose

daqAdcTransferSetBuffer

configures transfer buffers for acquired data, and can also be used to

configure the specified user- or driver-allocated buffers for subsequent acquisition transfers.

Parameter Summary

Parameter Type

Description

handle DaqHandleT

Handle to the device for which an ADC transfer is to be
performed

buf PDWORD

Pointer to the buffer for which the acquired data is to be
placed

scanCount DWORD

The total length of the buffer (in scans)

transferMask DWORD

Configures the buffer transfer mode

Parameter Values

handle:

obtained from the daqOpen function

buf:

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

(scanCount) * scan size * 2 (the sample size, normally 2 bytes)
scanCount:

valid values for buffer length are 1 to 4,294,967,295 scans, however, memory limitaions apply

transferMask:

see table below

Parameter Type Definitions

transferMask

Definition

Description

DatmCycleOn

Defines the buffer as a circular buffer

DatmCycleOff

Defines the buffer as a linear buffer

DatmUpdateSingle

Defines the update mode as single sample

DatmUpdateBlock

Defines the update mode as block update

DatmDriverBuf

Causes the driver to allocate the acquisition transfer buffer as a circular buffer

DatmUserBuf

Specifies a user-allocated and managed acquisition transfer buffer

DatmIgnoreOverruns

Ignores buffer overruns. Upon a buffer wrap, no error will be returned.

Returns

DerrNoError

No error

4.2-62 Daq API Command Reference

988594

Programmer’s Manual