DAQmxBaseReadDigitalU32

int32 DAQmxBaseReadDigitalU32 (TaskHandle taskHandle, int32 numSampsPerChan, float64 timeout, bool32 fillMode, uInt32 readArray[ ], uInt32 arraySizeInSamps, int32 *sampsPerChanRead, bool32 *reserved);

Purpose

Reads multiple 32-bit integer samples from a task that contains one or more digital input channels. Use this return type for devices with up to 32 lines per port. The data is returned in unsigned integer format.

Parameters

Input
Name Type Description
taskHandle TaskHandle The task to read samples from.
numSampsPerChan int32 The number of samples, per channel, to read. The default value of -1 (DAQmx_Val_Auto) reads all available data. If readArray does not contain enough space, this function returns as much data as fits in readArray.

NI-DAQmx Base determines how many samples to read based on whether the task acquires samples continuously or acquires a finite number of samples.

If the task acquires samples continuously and you set this parameter to -1, this function reads all the samples currently available in the buffer.

If the task acquires a finite number of samples and you set this parameter to -1, the function waits for the task to acquire all requested samples, and then reads those samples.
timeout float64 The amount of time, in seconds, to wait for the function to read the sample(s). This function returns an error if the timeout elapses.

fillMode bool32 Specifies whether or not the samples are interleaved.
Value Description
DAQmx_Val_GroupByChannel Group by channel (non-interleaved)
DAQmx_Val_GroupByScanNumber Group by scan number (interleaved)
arraySizeInSamps uInt32 The size of the array, in samples, into which data is read.
reserved bool32 * Reserved for future use. Pass NULL to this parameter.
Output
Name Type Description
readArray uInt32 [ ] The array to read data into, organized according to fillMode.
sampsPerChanRead int32 * The actual number of samples read from each channel.

Return Value

Name Type Description
status int32 The error code returned by the function in the event of an error or warning. A value of 0 indicates success. A positive value indicates a warning. A negative value indicates an error.