pipx40_setChannelPattern

ViStatus pipx40_setChannelPattern (ViSession instrumentHandle, ViUInt32 subunitNumber, unsigned long pattern[]);

Purpose

Sets all channels of an output sub-unit using a supplied bit-pattern.

Parameters

Input
Name Type Description
instrumentHandle ViSession

Instrument handle obtained by the pipx40_init call used to open the card.

subunitNumber ViUInt32

The number of the sub-unit to access.
Valid Values:  1 thru the number of output sub-units
available on the chosen card

pattern unsigned long []

Array containing the bit-pattern to be written to the chosen sub-unit.
A '0' bit in the pattern deactivates the corresponding channel or sets logic '0'.
A '1' bit in the pattern activates the corresponding channel or sets logic '1'.
Channel 1 is represented in the least significant bit of the least significant element of the array.
NOTE: the number of least significant bits appropriate to the size of the chosen sub-unit will be written. If the array passed contains insufficient bits, spurious data will be written to higher-numbered channels.

Return Value

Name Type Description
status ViStatus

A numeric code indicating the success or failure of the operation.
VI_SUCCESS = Successful operation.
Negative values are error codes and positive values are warnings.
To get a description of an error, pass the error code to pipx40_error_message.

References

Switching and GP Output
Pickering Interfaces PXI VISA
Alphabetical Function Index
Hierarchical Function Index