DAQmxGetNthTaskReadChannel

NI-DAQmx C Functions

DAQmxGetNthTaskReadChannel

int32 DAQmxGetNthTaskReadChannel (TaskHandle taskHandle, uInt32 index, char buffer[], int32 bufferSize);

Purpose

Takes a task, an index, and a user declared buffer with size. It fills out the buffer with the Nth channel as requested by the user in the index. This comes from all the channels in the task. Indexing starts at 1.

Parameters

Input
Name Type Description
taskHandle TaskHandle The task used in this function.
index uInt32 The Nth channel to return. The index starts at 1.
bufferSize int32 The size, in bytes, of buffer. If you pass 0, this function returns the number of bytes needed to allocate.
Output
buffer char [] The Nth channel in the index. If you pass NULL, this function returns the number of bytes needed to allocate.

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 negative value indicates an error.
For this function, if you pass NULL for the buffer or 0 for the buffer size, this function returns the number of bytes needed to allocate.