Sub-unit Status
Description
Obtains the current status flags for the specified output sub-unit. Status bits associated with significant card-level conditions are also returned.
Prototype
DWORD PIPLX_SubStatus(SESSION session. DWORD CardNum, DWORD SubNum);
Parameters:
Session - The session variable obtained from the PICMLX_Connect call
CardNum - card number
SubNum - sub-unit number
Returns:
A value representing the sub-unit's status flags.
Status Bit Definitions
Status bits are as follows:
0x80000000 - STAT_NO_CARD (no card with specified number)
0x40000000 - STAT_WRONG_DRIVER (card requires newer driver)
0x20000000 - STAT_EEPROM_ERR (card EEPROM fault)
0x10000000 - STAT_DISABLED (card disabled)
0x08000000 - STAT_NO_SUB (no sub-unit with specified number)
0x04000000 - STAT_BUSY (sub-unit operations not completed)
0x02000000 - STAT_HW_FAULT (card hardware defect)
0x01000000 - STAT_PARITY_ERROR (PCIbus parity error)
0x00800000 - STAT_PSU_INHIBITED (power supply output is disabled - by software)
0x00400000 - STAT_PSU_SHUTDOWN (power supply output is shutdown - due to overload)
0x00200000 - STAT_PSU_CURRENT_LIMIT (power supply is operating in current-limited mode)
0x00100000 - STAT_CORRUPTED (sub-unit logical state is corrupted)
0x00000000 - STAT_OK (card functional and stable)
Corresponding enumerated constants are provided in PILPXI.H.
Notes
Certain status bits are relevant only for particular classes of sub-unit.
Diagnostic information on fault conditions indicated in the status value can be obtained using PIPLX_Diagnostic.
Related functions