NI-DAQmx .NET Framework 4.0 API Reference

DigitalMultiChannelWriter.WriteSingleSamplePort Method (Boolean, Byte[])

  • Updated2023-02-21
  • 2 minute(s) read
DigitalMultiChannelWriter.WriteSingleSamplePort Method (Boolean, Byte[])
Writes a single 8-bit unsigned integer sample to one or more DOChannel objects in a task.

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

Syntax

public void WriteSingleSamplePort(
	bool autoStart,
	byte[] data
)
Public Sub WriteSingleSamplePort ( 
	autoStart As Boolean,
	data As Byte()
)

Parameters

autoStart
Type: SystemBoolean
If set to this method automatically calls Start if you do not explicitly call it. You cannot set this parameter to if you have installed events on the task.
data
Type: SystemByte
A 1D array of 8-bit unsigned integer samples to write to the task. Each element in the array corresponds to a channel in the task. The order of the channels in the array correspond to the order in which you add the channels to the task. The order of the lines in the array corresponds to the order in which you add the lines to the channel.

Exceptions

ExceptionCondition
DaqExceptionThe NI-DAQmx driver returned an error.
IndexOutOfRangeExceptiondata has a non-zero lower bound.

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.

This method returns immediately if the output buffer has sufficient space for the samples. Otherwise, the call is blocked until the application generates enough samples to fit the new data into the output buffer.

See Also