pipx40_resGetInfo

ViStatus pipx40_resGetInfo (ViSession instrumentHandle, ViUInt32 subunitNumber, ViPReal64 minResistance, ViPReal64 maxResistance, ViPReal64 refResistance, ViPReal64 precisionPercent, ViPReal64 precisionDelta, ViPReal64 internal1, ViPReal64 internalDelta, ViPUInt32 capabilities);

Purpose

Obtains detailed information about a precision programmable resistor sub-unit.
This information is currently only available for "Precision" resistor models; other types will respond with null values.

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:  must correspond to a programmable resistor
sub-unit of the chosen card

Output
Name Type Description
minResistance ViReal64 (passed by reference)

Variable to receive the minimum in-range resistance setting, in ohms.

maxResistance ViReal64 (passed by reference)

Variable to receive the maximum in-range resistance setting, in ohms.

refResistance ViReal64 (passed by reference)

Variable to receive the reference resistance value, in ohms.
This value applies only for models that support it, such as 40-265.

precisionPercent ViReal64 (passed by reference)

Variable to receive the percentage precision (in percent).
Example value: 0.2, in a model whose precision is specified as (+/-0.2%, +/-0.1 ohms).

precisionDelta ViReal64 (passed by reference)

Variable to receive the delta precision, in ohms.
Example value: 0.1, in a model whose precision is specified as (+/-0.2%, +/-0.1 ohms).

internal1 ViReal64 (passed by reference)

Variable - currently unused.

internalDelta ViReal64 (passed by reference)

Variable to receive the internal precision, in ohms.

capabilities ViUInt32 (passed by reference)

Variable to receive the sub-unit's capabilities flags.
Bit Significance:
0x00000000 = pipx40_RES_CAP_NONE
No special capabilities
0x00000001 = pipx40_RES_CAP_PREC
Precision resistor - supporting function
pipx40_resSetResistance etc.
0x00000002 = pipx40_RES_CAP_ZERO
Supports "zero ohms" setting (short circuit)
0x00000004 = pipx40_RES_CAP_INF
Supports infinity setting (open circuit)
0x00000008 = pipx40_RES_CAP_REF
Supports reference calibration value

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

Precision Programmable Resistor
Pickering Interfaces PXI VISA
Alphabetical Function Index
Hierarchical Function Index