pipx40_getChannelPattern

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

Purpose

Obtains a bit-pattern representation of the states of all channels of an output sub-unit.

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

Output
Name Type Description
pattern unsigned long []

Array to receive a bit-pattern representing the current state of the chosen output sub-unit.
A '0' bit in the pattern indicates the corresponding channel is inactive or logic '0'.
A '1' bit in the pattern indicates the corresponding channel is active or logic '1'.
Channel 1 is represented in the least significant bit of the least significant element of the array.
NOTE: the number of 32-bit longwords appropriate to the size of the chosen sub-unit will be overwritten. If the array passed is of insufficient size overspill will occur, causing corruption of adjacent memory.

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