NI-DAQmx .NET Framework 4.0 API Reference

Table of Contents

DigitalSingleChannelReader.ReadMultiSamplePortByte Method

  • Updated2023-02-21
  • 1 minute(s) read
DigitalSingleChannelReader.ReadMultiSamplePortByte Method
Reads one or more 8-bit unsigned integer samples from a single DIChannel in a task.

Namespace:  NationalInstruments.DAQmx
Assembly:  NationalInstruments.DAQmx (in NationalInstruments.DAQmx.dll) Version: 20.7.40.49302

Syntax

public byte[] ReadMultiSamplePortByte(
	int numberOfSamples
)
Public Function ReadMultiSamplePortByte ( 
	numberOfSamples As Integer
) As Byte()

Parameters

numberOfSamples
Type: SystemInt32
The number of samples to read. If you set numberOfSamples to -1 for a continuous acquisition, the read retrieves all samples available in the buffer at the time of the read. If you set numberOfSamples to -1 for a finite acquisition, the read behavior is set by the ReadAllAvailableSamples property of the DaqStream you are reading from.

Return Value

Type: Byte
A 1D array of 8-bit unsigned integer samples from the task. Each element in the array corresponds to a sample from the task.

Exceptions

ExceptionCondition
DaqExceptionThe NI-DAQmx driver returned an error.
OutOfMemoryExceptionThere is not enough memory to carry out this operation.

Remarks

Use this method for devices with up to eight lines per port.

NI-DAQmx read and write methods time out after the amount of time specified by the Timeout property on the task you are reading from or writing to.

Refer to NI-DAQmx Readers and Writers for more information about memory limitations in NI-DAQmx read methods.

See Also

Log in to get a better experience