NI-DAQmx .NET Framework 4.0 API Reference

Table of Contents
Table of Contents

DigitalMultiChannelReader.ReadMultiSamplePortInt16 Method

Download PDF
Selected SectionSelected Section and Subsection(s)Entire Manual
  • Updated2023-02-21
  • 2 minute(s) read
DigitalMultiChannelReader.ReadMultiSamplePortInt16 Method
Reads one or more 16-bit integer samples from one or more DIChannel objects in a task.

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

Syntax

public short[,] ReadMultiSamplePortInt16(
	int samplesPerChannel
)
Public Function ReadMultiSamplePortInt16 ( 
	samplesPerChannel As Integer
) As Short(,)

Parameters

samplesPerChannel
Type: SystemInt32
The number of samples to read. If you set samplesPerChannel to -1 for a continuous acquisition, the read retrieves all samples available in the buffer at the time of the read. If you set samplesPerChannel 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: Int16
A 2D array of 16-bit integer samples from the task. Each element in the first dimension of the array corresponds to a channel in the task. Each element in the second dimension of the array corresponds to a sample from each channel. The order of the channels in the array corresponds to the order in which you add the channels to the task or to the order of the channels you specify in ChannelsToRead.

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 16 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

Previous

No previous section

Next

No next section

Previous

No previous section

Next

No next section

Log in to get a better experience

Log in