pipx40_getCardStatus

 

VB

Function

pipx40_getCardStatus (ByVal vi As Long, ByRef status As Long) As Long

C++

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.