pipx40_getSubStatus
|
Function |
pipx40_getSubStatus (ByVal vi As Long, ByVal subUnit As Long, ByRef status As Long) As Long | |
|
ViStatus |
pipx40_getSubStatus (ViSession vi, ViUInt32 subUnit, ViPUInt32 status); |
|
Parameter |
I/O |
Description |
|
vi |
in |
Instrument handle |
|
subUnit |
in |
Numeric variable indicating the sub-unit for which information is to be obtained |
|
status |
out |
A value representing the sub-unit'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 sub-unit.
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 sub-unit 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_NO_SUB |
08000000 |
Card has no sub-unit with specified number |
|
pipx40_STAT_BUSY |
04000000 |
Sub-unit operations not yet completed |
|
pipx40_STAT_HW_FAULT |
02000000 |
Card hardware defect |
|
pipx40_STAT_PARITY_ERROR |
01000000 |
PCIbus parity error |
|
pipx40_STAT_PSU_INHIBITED |
00800000 |
PSU sub-unit - supply is disabled (by software) |
|
pipx40_STAT_PSU_SHUTDOWN |
00400000 |
PSU sub-unit - supply is shutdown (due to overload) |
|
pipx40_STAT_PSU_CURRENT_LIMIT |
00200000 |
PSU sub-unit - supply is operating in current-limited mode |
|
pipx40_STAT_CORRUPTED |
00100000 |
Sub-unit logical state is corrupted |
|
pipx40_STAT_CARD_INACCESSIBLE |
00080000 |
Card cannot be accessed (failed/removed/unpowered) |
Note that certain card-level conditions that affect the sub-unit's functionality are also reported.
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.