Chapter 2 Function Reference — WFM_DB_Config
NI-DAQ FRM for PC Compatibles 2-412
©
National Instruments Corporation
oldDataStop is a flag whose value enables or disables the mechanism whereby NI-DA Q stops
the waveform generation when NI-DAQ it is about to generate old data (data t hat has already
been generated) a second time. Setting oldDataStop to1 ensures seamless double-buffered
waveform generation.
0: Allow regeneration of data.
1: Disallow regeneration of data.
partialTransferStop is a flag indicating whether to stop waveform generation when NI-DAQ
transfers a partial half buffer to the analog output buffer using a WFM_DB_Transfer call.
NI-DAQ stops the waveform when NI-DAQ has output the partial half buffer.
0: Allow partial half buffer transfers.
1: Stop waveform generation after partial half buffer transfers.
Using This Function
Use WFM_DB_Config to turn double-buffered waveform generation on and off. With the
double-buffered mode enabled, you can use WFM_DB_Transfer to transfer new data into the
waveform buffer (selected by WFM_Load) as NI-DAQ generates the wav eform. Because of the
extra bookkeeping involved, unless you are going to use WFM_DB_Transfer, you should
leave double buffering disabled. Refer to Chapter 5, NI-DAQ Double Buffering, of the
NI-DAQ User Manual for PC Compatibles for a detailed discussion of double buffering.
If you are using DMA, enabling partialTransferStop (or oldDataStop) causes an artificial
split in the waveform buffer, which requires DMA reprogramming at the end of each half
buffer. Therefore, you should only enable these options if necessary.
(AT-AO-6/10 only) For double-buffered waveform generation with group 1 channels using
DMA: If oldDataStop is enabled, partial half buffer transfers (using WFM_DB_Transfer
calls) are only allowed if partialTransferStop is enabled.
For double-buffered waveform generation wit h group 1: The total number of po ints for all the
group 1 channels (specified in WFM_Load) should be at least twice the size of the FIFO. Refer
to the AT-AO-6/10 User Manual for information on the AT-AO-6/10 FIFO size.
(AT-MIO-16F-5 only) When using the double-buffered waveform generation and
oldDataStop mode is enabled, the driver can alter bit15 of the data points in the
waveform buffer.