StartFunction Method (string, string, XJEaseParameterCollection, XJEaseParameterCollection)

Runs an XJEase function with the specified name from the given device's test device file. The XJEase functions are run asynchronously, i.e. control returns immediately from this method and the XJEase code continues to run on a separate thread.

Type: Runner

Namespace: XJTAG.Integration.XJRunner

Syntax

public void StartFunction(string device, string functionName, XJEaseParameterCollection inputArgs, XJEaseParameterCollection outputArgs)

Parameters

device

Type: string

The name of the device on which to run the function. If there are multiple boards in the project, the device name should be in the form Board.Device.

functionName

Type: string

The name of the XJEase test function to run.

inputArgs

Type: XJEaseParameterCollection

The XJEaseParameterCollection of input arguments for the function. An arbitrary number of IntParameter, StringParameter and XJEaseArrayParameter arguments can be added to the collection, corresponding to the parameters for the function to be run.

outputArgs

Type: XJEaseParameterCollection

The XJEaseParameterCollection of initial values for the output arguments; individual arguments can be initialised as null.

Exceptions

RuntimeException

There was an error running the XJEase code.

System.ArgumentException

The function name was an empty string.

System.ArgumentNullException

Any of the arguments were null.

System.ObjectDisposedException

The Runner has already been disposed.

XJTAG v4.2.5