DAQmxReadDigitalScalarU32

NI-DAQmx C Functions

DAQmxReadDigitalScalarU32

int32 DAQmxReadDigitalScalarU32 (TaskHandle taskHandle, float64 timeout, uInt32 *value, bool32 *reserved);

Purpose

Reads a single 32-bit integer sample from a task that contains a single digital input channel. Use this function for devices with up to 32 lines per port. The sample is returned in unsigned integer format.

Parameters

Input
Name Type Description
taskHandle TaskHandle The task to read the sample from.
timeout float64 The amount of time, in seconds, to wait for the function to read the sample. The default value is 10.0 seconds. To specify an infinite wait, pass -1 (DAQmx_Val_WaitInfinitely). This function returns an error if the timeout elapses.
A value of 0 indicates to try once to read the requested sample. If the entire requested sample is read, the function is successful. Otherwise, the function returns a timeout error and returns what was actually read.
reserved bool32 * Reserved for future use. Pass NULL to this parameter.
Output
Name Type Description
value uInt32 * The sample read from the task.

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.