DigitalMultiChannelWriter.BeginWriteSingleSampleSingleLine Method
- Updated2023-02-21
- 2 minute(s) read
DigitalMultiChannelWriterBeginWriteSingleSampleSingleLine Method
Namespace: NationalInstruments.DAQmx
Assembly: NationalInstruments.DAQmx (in NationalInstruments.DAQmx.dll) Version: 20.7.40.49302
Syntax
public IAsyncResult BeginWriteSingleSampleSingleLine( bool autoStart, bool[] data, AsyncCallback callback, Object state )
Public Function BeginWriteSingleSampleSingleLine ( autoStart As Boolean, data As Boolean(), callback As AsyncCallback, state As Object ) As IAsyncResult
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: SystemBoolean
A 1D array of Boolean samples to write to the task. Each element of the array corresponds to a channel within 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. - callback
- Type: SystemAsyncCallback
An optional asynchronous callback that is called when the write is complete. Specify if you do not want a callback when the write is complete. - state
- Type: SystemObject
A user-provided object that distinguishes this asynchronous write request from other requests. Use this parameter to provide information to the callback. Specify if you do not need to pass any additional information to the callback.
Return Value
Type: IAsyncResultAn IAsyncResult that represents the asynchronous call.
Remarks
Pass the returned IAsyncResult to EndWrite(IAsyncResult) to get any exceptions that occurred during the asynchronous write or to wait for the write to complete.
This method fails if the channels in the task contain more than one digital line.
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.
![]() |
---|
Refer to Asynchronous Reads and Writes for additional information. |