pipx40_getCardStatus

ViStatus pipx40_getCardStatus (ViSession instrumentHandle, ViPUInt32 cardStatus);

Purpose

Obtains bit-flags indicating the current operational status of a card.
Diagnostic information on any fault conditions indicated in the status value can be obtained using "Get Diagnostic Information" - function pipx40_getDiagnostic().

Parameters

Input
Name Type Description
instrumentHandle ViSession

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

Output
Name Type Description
cardStatus ViUInt32 (passed by reference)

Variable to receive a set of bit-flags indicating the current operational status of the card.
Bit Significance:
0x00000000 = pipx40_STAT_OK
Card functional and stable
0x80000000 = pipx40_STAT_NO_CARD
No Pickering card open on the session
0x40000000 = pipx40_STAT_WRONG_DRIVER
Card requires later driver version
0x20000000 = pipx40_STAT_EEPROM_ERR
Error interpreting card EEPROM data
0x10000000 = pipx40_STAT_DISABLED
Card is disabled
0x04000000 = pipx40_STAT_BUSY
Card operations not yet completed
0x02000000 = pipx40_STAT_HW_FAULT
Hardware fault
0x01000000 = pipx40_STAT_PARITY_ERROR
PCIbus parity error
0x00080000 = pipx40_STAT_CARD_INACCESSIBLE
Card cannot be accessed
(failed/removed/unpowered)
0x00040000 = pipx40_STAT_UNCALIBRATED
One or more sub-units is uncalibrated
0x00020000 = pipx40_STAT_CALIBRATION_DUE
One or more sub-units is due for calibration

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

ID & Status
Pickering Interfaces PXI VISA
Alphabetical Function Index
Hierarchical Function Index