pipx40_self_test

 

VB

Function

pipx40_self_test (ByVal vi As Long, ByRef test_result As Integer, ByVal test_message As String) As Long

C++

ViStatus

pipx40_self_test (ViSession vi, ViPInt16 test_result, ViString test_message);

 

Parameter

I/O

Description

vi

in

Instrument handle

test_result

out

Numeric result from self-test operation

test_message

out

Self-test status message

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

This function causes the instrument to perform a self-test and returns the result of that self-test.

Remarks

The test_result parameter is a numeric code for the test result. The test_message parameter returns a self-test status message. The codes are listed in the table below.

Driver constant

Numeric

Value

Description

 

0

Self-test passed with no errors

pipx40_FAULT_UNKNOWN

1

Unspecified fault

pipx40_FAULT_WRONG_DRIVER

2

Incompatible software driver version

pipx40_FAULT_EEPROM_ERROR

3

EEPROM data error

pipx40_FAULT_HARDWARE

4

Hardware defect

pipx40_FAULT_PARITY

5

Parity error

pipx40_FAULT_CARD_INACCESSIBLE

6

Card cannot be accessed (failed/removed/unpowered)

 

 

Diagnostic information on fault conditions indicated in the test result can be obtained using pipx40_getDiagnostic.