BufferingConfig (Data Acquisition Toolbox)

BufferingConfig is a two-element vector that specifies the per-channel allocated memory. The first element of the vector specifies the block size, while the second element of the vector specifies the number of blocks. The total allocated memory (in bytes) is given by (block size) × (number of blocks) × (number of channels) × (native data type).

Memory can be allocated either automatically by the engine or manually depending on the value of BufferingMode. If BufferingMode is Auto, the BufferingConfig values are automatically set by the engine. If BufferingMode is Manual, then you must manually set the BufferingConfig values. If you change the BufferingConfig values, BufferingMode is automatically set to Manual.

When memory is automatically allocated by the engine, the block-size value depends on the sampling rate and is typically a binary number. The number of blocks is initially set to a value of 30 but can dynamically increase to accommodate the needs of the engine. In most cases, the number of blocks used results in a per-channel memory that is somewhat greater than the SamplesPerTrigger value. When you manually allocate memory, the number of blocks is not dynamic and care must be taken to ensure there is sufficient memory to store the acquired data.

If the number of samples requested exceeds the available memory, an out-of-memory error is returned.

Characteristics


Device Objects	AI, AO
Class	Common
Access	Read/write
Data Type	Vector of doubles
Modify while Running	No

Values

The default value is determined by the engine.