Error Codes

Each function in this instrument driver returns a status code that either indicates success or describes an error or warning condition. Your program should examine the status code from each call to an instrument driver function to determine if an error occurred. The general meaning of the status code is as follows:

Value Meaning

-------------------------------

0 Success

Positive Values Warnings

Negative Values Errors

This driver defines the following status codes:

Driver Error:	Error String:	Error Code (in Hex):
PI40IV_ERROR_BAD_SESSION	Not a valid pi40iv session	BFFA4001
PI40IV_ERROR_NO_INFO	Card information unobtainable	BFFA4002
PI40IV_ERROR_CARD_DISABLED	Card disabled	BFFA4003
PI40IV_ERROR_BAD_SUB	Invalid sub-unit number	BFFA4004
PI40IV_ERROR_BAD_CHANNEL	Invalid channel number	BFFA4005
PI40IV_ERROR_NO_CAL_DATA	Target has no calibration data	BFFA4006
PI40IV_ERROR_BAD_ARRAY	Incompatible safearray	BFFA4007
PI40IV_ERROR_MUX_ILLEGAL	Illegal MUX data	BFFA4008
PI40IV_ERROR_EXCESS_CLOSURE	Closure limit exceeded	BFFA4009
PI40IV_ERROR_ILLEGAL_MASK	Illegal mask data	BFFA400A
PI40IV_ERROR_OUTPUT_MASKED	Masked channel(s) cannot be closed	BFFA400B
PI40IV_ERROR_FAILED_INIT	Cannot open a Pickering card with this resource name	BFFA400C
PI40IV_ERROR_READ_FAIL	Failed to read from hardware	BFFA400D
PI40IV_ERROR_WRITE_FAIL	Failed to write to hardwar	BFFA400E
PI40IV_ERROR_VISA_OP	VISA operation failed	BFFA400F
PI40IV_ERROR_VISA_VERSION	Incompatible VISA version	BFFA4010
PI40IV_ERROR_CORE_DRIVER_UNKNOWN	Unspecified core driver error	BFFA4011
PI40IV_ERROR_STAT_NO_CARD	No Pickering card open on the session	BFFA4012
PI40IV_ERROR_STAT_WRONG_DRIVER	Card requires later driver version	BFFA4013
PI40IV_ERROR_STAT_EEPROM_ERR	Error interpreting card EEPROM data	BFFA4014
PI40IV_ERROR_STAT_DISABLED	Card is disabled	BFFA4015
PI40IV_ERROR_STAT_NO_SUB	Card has no sub-unit with specified number	BFFA4016
PI40IV_ERROR_STAT_HW_FAULT	Hardware fault (eg. defective serial loop)	BFFA4017
PI40IV_ERROR_INI_MODULE_NOT_FOUND	Module not found in pi40iv.ini	BFFA4018
PI40IV_ERROR_INI_FORMAT_VERSION	Wrong format version of pi40iv.ini	BFFA4019
PI40IV_ERROR_INI_FILE_NOT_FOUND	pi40iv.ini not found	BFFA401A
PI40IV_ERROR_INI_MFG_NO	Wrong manufacturer number	BFFA401B
PI40IV_ERROR_NO_SETUP_MODEL_INFO	Failed to receive setup information about "Model"	BFFA401C
PI40IV_ERROR_READING_REGISTRY	Failed to read INI file path from windows registry	BFFA401D
PI40IV_ERROR_WRONG_CARD_VALUES	Card indicating other size than INI file values	BFFA401E

This instrument driver also returns errors and warnings defined by other sources. The following table defines the ranges of additional status codes that this driver can return. The table lists the different include files that contain the defined constants for the particular status codes:

Numeric Range (in Hex) Status Code Types

-------------------------------------------------

3FFA2000 to 3FFA3FFF IviSwtch Warnings

3FFA0000 to 3FFA1FFF IVI Warnings

3FFF0000 to 3FFFFFFF VISA Warnings

3FFC0000 to 3FFCFFFF VXIPnP Driver Warnings

BFFA2000 to BFFA3FFF IviSwtch Errors

BFFA0000 to BFFA1FFF IVI Errors

BFFF0000 to BFFFFFFF VISA Errors

BFFC0000 to BFFCFFFF VXIPnP Driver Errors