Reads from analog inputs immediately.

Namespace:  Quanser.Hardware
Assembly:  Quanser.Hardware.Hil (in Quanser.Hardware.Hil.dll)

Syntax

Visual Basic (Declaration)
Public Sub ReadAnalog ( _
	channels As Integer(), _
	voltages As Double() _
)
C#
public void ReadAnalog(
	int[] channels,
	double[] voltages
)
Visual C++
public:
void ReadAnalog(
	array<int>^ channels, 
	array<double>^ voltages
)
JavaScript
function readAnalog(channels, voltages);

Parameters

channels
Type: array< System..::.Int32 >[]()[]

An array containing the numbers of the analog input channels to be read. Channel numbers are zero-based. Thus, channel 0 is the first channel, channel 1 the second channel, etc.

Select a board type from the list for board-specific details: .

voltages
Type: array< System..::.Double >[]()[]

An array for receiving the voltage values read from the analog inputs. Each element in the voltages array corresponds to the same element in the channels array. Hence, there must be as many elements in the voltages array as there are channels.

Remarks

The ReadAnalog method reads from the specified analog input channels immediately. The method does not return until the data has been read.

Examples

This example illustrates how to read analog inputs immediately. It reads analog channels 0-3. Exceptions are ignored for simplicity.
C# Copy Code
int []    channels = { 0, 1, 2, 3 };
double [] buffer   = new double [channels.Length];

card.ReadAnalog(channels, buffer);
Visual Basic Copy Code
Dim channels() As Integer = {0, 1, 2, 3}
Dim buffer(channels.Length - 1) As Double

card.ReadAnalog(channels, buffer)
Visual C++ Copy Code
array<int>^    channels = { 0, 1, 2, 3 };
array<double>^ buffer   = gcnew array<double>(channels->Length);

card->ReadAnalog(channels, buffer);

Exceptions

ExceptionCondition
Quanser.Hardware..::.HilException If the read cannot be performed then an exception is thrown. This situtation typically arises if the board does not support analog inputs or the hardware resources required are in use by a task.

See Also