Daqadcsofttrig, Daqadctransferbufdata – Measurement Computing Personal Daq rev.6.0 User Manual

Page 147

Advertising
background image

Personal Daq User’s Manual

Appendix B,

887095

API Commands B-15

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

See Also

daqAdcSetTrig, daqAdcSetAcq

Program References

None

Used With

All devices

Description

daqAdcSoftTrig

is used to send a software trigger command to the Personal 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, PVOID buf, DWORD scanCount,

daqAdcBufferXferMask bufMask, PDWORD retCount);

C

daqAdcTransferBufData(DaqHandleT handle, PVOID buf, DWORD scanCount,

DaqAdcBufferXferMask bufMask, PDWORD retCount);

Visual BASIC

VBdaqAdcTransferBufDataSingle&(ByVal handle&, buf!(), ByVal ScanCount&, ByVal

transferMask&, retCount&)

Delphi

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

bufMask:DaqAdcBufferXferMask; retCount:DWORD);

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

Parameters

retCount

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

Returns

DerrNoError

No error

See Also

daqAdcTransferSetBuffer, daqAdcTransferGetStat

Program References

Used With

All devices

Description

daqAdcTransferBufData

requests a transfer of scanCount scans from the driver-allocated 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. Scan 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 the acquisition buffer, the function will return with retCount set to scanCount, the
number of scans requested. Scan 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. Scan 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.

Advertising
This manual is related to the following products: