Measurement Computing WaveBook rev.3.0 - Manual (Page 211)

WaveBook User’s Manual, 6-24-99 daqX API - Command Reference D-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 the API Error Codes table at the end of this chapter).
See Also daqAdcSetTrig, daqAdcSetAcq
Program References None
Used With All devices
Description
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);
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 the API Error Codes table at the end of this chapter).
See Also daqAdcTransferSetBuffer, daqAdcTransferGetStat
Program References ADCEX9.C, ADCEX10.C
Used With All devices
Description
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.