pipx40_getCardStatus
Function |
pipx40_getCardStatus (ByVal vi As Long, ByRef status As Long) As Long | |
ViStatus |
pipx40_getCardStatus (ViSession vi, ViPUInt32 status); |
Parameter |
I/O |
Description |
vi |
in |
Instrument handle |
status |
out |
A value representing the card's status flags |
Return Value
0 = Successful operation. Negative values are error codes and positive values are warnings. To get a description of the error, pass the error code to pipx40_error_message.
Description
Obtains the current status flags for the specified card.
Remarks
The status value is composed of the sum of a number of individual flag bits.
A zero value (pipx40_STAT_OK) indicates that the card is functional and its outputs are stable.
Driver constant |
Bit value - hexadecimal |
Description |
pipx40_STAT_NO_CARD |
80000000 |
The specified session is not associated with a Pickering card |
pipx40_STAT_WRONG_DRIVER |
40000000 |
Card requires a more recent version of the software driver |
pipx40_STAT_EEPROM_ERR |
20000000 |
Card EEPROM fault |
pipx40_STAT_DISABLED |
10000000 |
Card disabled |
pipx40_STAT_BUSY |
04000000 |
Card operations not yet completed |
pipx40_STAT_HW_FAULT |
02000000 |
Card hardware defect |
pipx40_STAT_PARITY_ERROR |
01000000 |
PCIbus parity error |
pipx40_STAT_CARD_INACCESSIBLE |
00080000 |
Card cannot be accessed (failed/removed/unpowered) |
Diagnostic information on fault conditions indicated in the status value can be obtained using pipx40_getDiagnostic.
VISA may not allow a card that has experienced a PCIbus parity error to be opened, so in practice pipx40_STAT_PARITY_ERROR can never be reported.