beautypg.com

Daqadcsofttrig, Daqadctransferbufdata – Measurement Computing TempBook rev.3.0 User Manual

Page 140

background image

11-16 daqCommand Reference (Enhanced API)

TempBook User’s Manual

daqAdcSoftTrig

DLL Function

daqAdcSoftTrig(DaqHandleT handle);

C

daqAdcSoftTrig(DaqHandleT handle);

Visual BASIC

VBdaqAdcSoftTrig&(ByVal handle&)

Delphi

daqAdcSoftTrig(handle:DaqHandleT)

Parameters

handle

Handle to the device to which the ADC software trigger is to be applied

Returns

DerrNoError

- No error (also, refer to API Error Codes on page 11-39)

See Also

daqAdcSetTrig, daqAdcSetAcq

Program References

None

Used With

All devices

daqAdcSoftTrig

is used to send a software trigger command to the Daq* device. This software

trigger can be used to initiate a scan or an acquisition from a program after configuring the software
trigger as the trigger source. This function may only be used if the trigger source for the acquisition
has been set to DatsSoftware with the daqAdcSetTrig function.

daqAdcTransferBufData

DLL Function

daqAdcTransferBufData(DaqHandleT handle, PWORD buf, DWORD scanCount,

DaqAdcBufferXferMask bufMask, PDWORD retCount);

C

daqAdcTransferBufData(DaqHandleT handle, PWORD buf, DWORD scanCount,

DaqAdcBufferXferMask bufMask, PDWORD retCount);

Visual BASIC

VBdaqAdcTransferBufData(ByVal handle, buf%, ByVal scanCount&, ByVal bufMask&,

retCount&);

Delphi

daqAdcTransferBufData(handle: DaqHandleT; buf : PWORD, scanCount : DWORD,

bufMask: DaqAdcBufferXferMask; retCount: PDWORD);

Parameters

handle

Handle to the device for which the ADC buffer should be retrieved.

buf

Pointer to an application-supplied buffer to place the buffered data.

scanCount

Number of scans to retrieve from the acquisition buffer.

bufMask

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

retCount

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

Returns

DerrNoError

- No error (also, refer to API Error Codes on page 11-39)

See Also

daqAdcTransferSetBuffer, daqAdcTransferGetStat

Program References

ADCEX9.C, ADCEX10.C

Used With

All devices

daqAdcTransferBufData

requests a transfer of scanCount scans from the driver-allocated

ADC acquisition buffer to the specified user-supplied buffer. The bufMask parameter can be used
to specify the conditions for the transfer as follows:

DabtmWait

- Instructs the function to wait until the requested number of scans are available

in the driver-allocated acquisition buffer. When the requested number of scans are available,
the function will return with retCount set to scanCount, the number of scans requested.
ADC data will be returned in the memory referred to by the buf parameter.

DabtmNoWait

- Instructs the function to return immediately if the specified number of scans

are not available when the function is called. If the entire amount requested is not available,
the function will return with no data and retCount will be set to 0. If the requested number
of scans are available in ADC acquisition buffer, the function will return with retCount set
to scanCount, the number of scans requested. ADC data will be returned in the memory
referred to by the buf parameter.

DabtmRetAvail

- Instructs the function to return immediately, regardless of the number of

scans available in the driver-allocated acquisition buffer. The retCount parameter will
return the total number of scans retrieved. retCount can return anything from 0 to
scanCount

, the number of scans requested. ADC data will be returned in the memory

referred to by the buf parameter.

The driver-allocated acquisition buffer must have been allocated prior to calling this function. This
is performed via the daqAdcTransferSetBuffer. Refer to daqAdcTransferSetBuffer
for more details on specifying the driver-allocated acquisition buffer.