Card Status

Description

Obtains the current status flags for the specified card.

Prototype

DWORD PIPLX_Status(SESSION session, DWORD CardNum);

Parameters:

Session - The session variable obtained from the PICMLX_Connect call

CardNum - card number

Returns:

A value representing the card'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)

0x04000000 - STAT_BUSY (card operations not completed)

0x02000000 - STAT_HW_FAULT (card hardware defect)

0x01000000 - STAT_PARITY_ERROR (PCIbus parity error)

0x00000000 - STAT_OK (card functional and stable)

Corresponding enumerated constants are provided in PILPXI_w32.h.

Notes

At card level, STAT_BUSY indicates if any of a card's sub-units have not yet stabilised.

 

Diagnostic information on fault conditions indicated in the status value can be obtained using PIPLX_Diagnostic.

Related functions

PIPLX_SubStatus