pipx40_self_test

ViStatus pipx40_self_test (ViSession instrumentHandle, ViPInt16 testResult, ViChar _VI_FAR testMessage[]);

Purpose

No actual test is performed as a consequence of executing this function, but any pre-existing faults are indicated in the result.
The card's state is unaffected.

Parameters

Input
Name Type Description
instrumentHandle ViSession

Instrument handle obtained by the pipx40_init call used to open the card.

Output
Name Type Description
testResult ViInt16 (passed by reference)

A numeric code indicating the result of the self test operation.
Result Codes:
1 = pipx40_FAULT_UNKNOWN
Unknown fault
2 = pipx40_FAULT_WRONG_DRIVER
Incompatible software driver version
3 = pipx40_FAULT_EEPROM_ERROR
EEPROM data error
4 = pipx40_FAULT_HARDWARE
Hardware defect
5 = pipx40_FAULT_PARITY
PCIbus parity error
6 = pipx40_FAULT_CARD_INACCESSIBLE
Card cannot be accessed
(failed/removed/unpowered)

testMessage ViChar[]

A text string describing the result of the self test operation.
The maximum length of the message is 256 characters (VISA specification).

Return Value

Name Type Description
status ViStatus

A numeric code indicating the success or failure of the operation.
VI_SUCCESS = Successful operation.
Negative values are error codes and positive values are warnings.
To get a description of an error, pass the error code to pipx40_error_message.

References

Utility
Pickering Interfaces PXI VISA
Alphabetical Function Index
Hierarchical Function Index