Analog Output

Configure the analog output subsystem and generate data. More...

Functions
UlError	ulAOut (DaqDeviceHandle daqDeviceHandle, int channel, Range range, AOutFlag flags, double data)
	Writes the value of a D/A output. More...
UlError	ulAOutArray (DaqDeviceHandle daqDeviceHandle, int lowChan, int highChan, Range range[], AOutArrayFlag flags, double data[])
	Writes values to a range of D/A channels. More...
UlError	ulAOutScan (DaqDeviceHandle daqDeviceHandle, int lowChan, int highChan, Range range, int samplesPerChan, double *rate, ScanOption options, AOutScanFlag flags, double data[])
	Writes values to a range of D/A channels. More...
UlError	ulAOutScanWait (DaqDeviceHandle daqDeviceHandle, WaitType waitType, long long waitParam, double timeout)
	Returns when the scan operation completes on the specified device, or the time specified by the timeout argument elapses. More...
UlError	ulAOutScanStatus (DaqDeviceHandle daqDeviceHandle, ScanStatus *status, TransferStatus *xferStatus)
	Returns the status, count, and index of a D/A scan operation. More...
UlError	ulAOutScanStop (DaqDeviceHandle daqDeviceHandle)
	Stops the analog output operation currently running. More...
UlError	ulAOutSetTrigger (DaqDeviceHandle daqDeviceHandle, TriggerType type, int trigChan, double level, double variance, unsigned int retriggerSampleCount)
	Configures the trigger parameters that will be used when ulAOutScan() is called with the SO_RETRIGGER or SO_EXTTRIGGER ScanOption. More...
UlError	ulAOGetInfo (DaqDeviceHandle daqDeviceHandle, AoInfoItem infoItem, unsigned int index, long long *infoValue)
	Use with AoInfoItem to retrieve information about the AO subsystem. More...
UlError	ulAOGetInfoDbl (DaqDeviceHandle daqDeviceHandle, AoInfoItemDbl infoItem, unsigned int index, double *infoValue)
	Use with AoInfoItemDbl to retrieve information about the AO subsystem. More...
UlError	ulAOSetConfig (DaqDeviceHandle daqDeviceHandle, AoConfigItem configItem, unsigned int index, long long configValue)
	Use with AoConfigItem to set configuration options at runtime. More...
UlError	ulAOGetConfig (DaqDeviceHandle daqDeviceHandle, AoConfigItem configItem, unsigned int index, long long *configValue)
	Use with AoConfigItem to retrieve configuration options set for a device. More...

Detailed Description

Configure the analog output subsystem and generate data.

Function Documentation

UlError ulAOGetConfig	(	DaqDeviceHandle	daqDeviceHandle,
		AoConfigItem	configItem,
		unsigned int	index,
		long long *	configValue
	)

Use with AoConfigItem to retrieve configuration options set for a device.

Parameters

daqDeviceHandle	the handle to the DAQ device
configItem	the configuration item to retrieve
index	either ignored or an index into the configValue
configValue	the specified configuration value is returned to this variable

Returns

The UL error code.

UlError ulAOGetInfo	(	DaqDeviceHandle	daqDeviceHandle,
		AoInfoItem	infoItem,
		unsigned int	index,
		long long *	infoValue
	)

Use with AoInfoItem to retrieve information about the AO subsystem.

Parameters

daqDeviceHandle	the handle to the DAQ device
infoItem	the analog output information to retrieve
index	either ignored or an index into the infoValue, depending on the value of the infoItem argument
infoValue	the AO information is returned to this variable

Returns

The UL error code.

UlError ulAOGetInfoDbl	(	DaqDeviceHandle	daqDeviceHandle,
		AoInfoItemDbl	infoItem,
		unsigned int	index,
		double *	infoValue
	)

Use with AoInfoItemDbl to retrieve information about the AO subsystem.

Parameters

daqDeviceHandle	the handle to the DAQ device
infoItem	the analog output information to retrieve
index	either ignored or an index into the infoValue
infoValue	the AO information is returned to this variable

Returns

The UL error code.

UlError ulAOSetConfig	(	DaqDeviceHandle	daqDeviceHandle,
		AoConfigItem	configItem,
		unsigned int	index,
		long long	configValue
	)

Use with AoConfigItem to set configuration options at runtime.

Parameters

daqDeviceHandle	the handle to the DAQ device
configItem	the configuration item to set
index	either ignored or an index into the configValue
configValue	the value to set the specified configuration item to

Returns

The UL error code.

UlError ulAOut	(	DaqDeviceHandle	daqDeviceHandle,
		int	channel,
		Range	range,
		AOutFlag	flags,
		double	data
	)

Writes the value of a D/A output.

Parameters

daqDeviceHandle	the handle to the DAQ device
channel	D/A channel number
range	D/A range
flags	bit mask that specifies whether to scale and/or calibrate the data
data	the value to write

Returns

The UL error code.

UlError ulAOutArray	(	DaqDeviceHandle	daqDeviceHandle,
		int	lowChan,
		int	highChan,
		Range	range[],
		AOutArrayFlag	flags,
		double	data[]
	)

Writes values to a range of D/A channels.

Parameters

daqDeviceHandle	the handle to the DAQ device
lowChan	first D/A channel
highChan	last D/A channel
range	D/A ranges
flags	bit mask that specifies whether to scale and/or calibrate the data
data[]	a pointer to an array that stores the data

Returns

The UL error code.

UlError ulAOutScan	(	DaqDeviceHandle	daqDeviceHandle,
		int	lowChan,
		int	highChan,
		Range	range,
		int	samplesPerChan,
		double *	rate,
		ScanOption	options,
		AOutScanFlag	flags,
		double	data[]
	)

Writes values to a range of D/A channels.

Parameters

daqDeviceHandle	the handle to the DAQ device
lowChan	first D/A channel in the scan
highChan	last D/A channel in the scan
range	D/A range
samplesPerChan	the number of D/A samples to output
rate	the sample rate in scans per second. Upon return, this value is set to the actual sample rate.
options	bit mask that specifies D/A scan options
flags	bit mask that specifies whether to scale and/or calibrate the data
data[]	a pointer to an array that stores the data

Returns

The UL error code.

UlError ulAOutScanStatus	(	DaqDeviceHandle	daqDeviceHandle,
		ScanStatus *	status,
		TransferStatus *	xferStatus
	)

Returns the status, count, and index of a D/A scan operation.

Parameters

daqDeviceHandle	the handle to the DAQ device
status	the status of the background operation
xferStatus	a TransferStatus struct containing fields that return the current sample count, scan count, and buffer index for the specified output scan operation

Returns

The UL error code.

UlError ulAOutScanStop

(

DaqDeviceHandle

daqDeviceHandle

)

Stops the analog output operation currently running.

Parameters

daqDeviceHandle

the handle to the DAQ device

Returns

The UL error code.

UlError ulAOutScanWait	(	DaqDeviceHandle	daqDeviceHandle,
		WaitType	waitType,
		long long	waitParam,
		double	timeout
	)

Returns when the scan operation completes on the specified device, or the time specified by the timeout argument elapses.

Parameters

daqDeviceHandle	the handle to the DAQ device
waitType	the wait type
waitParam	Reserved for future use
timeout	the timeout value in seconds (s); set to -1 to wait indefinitely for the scan operation to end.

Returns

The UL error code.

UlError ulAOutSetTrigger	(	DaqDeviceHandle	daqDeviceHandle,
		TriggerType	type,
		int	trigChan,
		double	level,
		double	variance,
		unsigned int	retriggerSampleCount
	)

Configures the trigger parameters that will be used when ulAOutScan() is called with the SO_RETRIGGER or SO_EXTTRIGGER ScanOption.

Parameters

daqDeviceHandle	the handle to the DAQ device
type	the trigger type
trigChan	the trigger channel; ignored if type is set to TRIG_POS_EDGE, TRIG_NEG_EDGE, TRIG_HIGH, TRIG_LOW, GATE_HIGH, GATE_LOW, TRIG_RISING, or TRIG_FALLING.
level	the level at or around which the trigger event should be detected; ignored if type is set to TRIG_POS_EDGE, TRIG_NEG_EDGE, TRIG_HIGH, TRIG_LOW, GATE_HIGH, GATE_LOW, TRIG_RISING, or TRIG_FALLING.
variance	the degree to which the input signal can vary relative to the level parameter; ignored for all types where level is ignored. For pattern triggering, this argument serves as the mask value.
retriggerSampleCount	the number of samples to generate with each trigger event; ignored unless the SO_RETRIGGER ScanOption is set for the scan.

Returns

The UL error code.