GxPsGetErrorString

Purpose

Returns the error string as specified by the error number.

Syntax

GxPsGetErrorString (nError,  pszMsg, nErrorMaxLen, pnStatus)

Parameters

Name
Type
Description
nError
SHORT
Error number.
pszMsg
PSTR
Buffer to the returned error string.
nStrMaxLen
SHORT
The size of the error string buffer.
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

The function returns the error string associated with the nError as returned from other driver functions.

The following table displays the possible error values; not all errors apply to this board type:

Resource Errors

0
No error has occurred
-1
Unable to open the HW driver - check if HW is properly installed
-2
Board does not exist in this slot/base address
-3
Different board exist in the specified PCI slot/base address
-4
PCI slot not configured properly. You may configure using the PciExplorer from the Windows Control Panel
-5
Unable to register the PCI device
-6
Unable to allocate system resource for the device
-7
Unable to allocate memory
-8
Unable to create panel
-9
Unable to create Windows timer
-10
Bad or Wrong board EEPROM
-11
Not in calibration mode
-12
Board is not calibrated
-13
Function is not supported by the specified board

 

General Parameter Errors

-20
Invalid or unknown error number
-21
Invalid parameter
-22
Illegal slot number
-23
Illegal board handle
-24
Illegal string length
-25
Illegal operation mode
-26
Parameter is out of the allowed range
-30
Unable to Load VISA32/64.DLL, make sure VISA library is installed
-31
Unable to open default VISA resource manager, make sure VISA is properly installed
-32
Unable to open the specified VISA resource
-33
VISA viGetAttribute error
-34
VISA viInXX error
-35
VISA ViMapAddress error
-37
Unable to create synchronization object
-38
This function is not available under LabView/Real-Time
-39
Unable to lock a board resource, resource is used by another process or thread
-40
Unable to execute this function. The function requires special license to be installed

 

Board Specific Errors

-50
Fatal error: Unable to set the Mode register
-51
Fatal error: Power supply not found!
-52
Fatal error: EEPROM not calibrated!
-53
Fatal error: Invalid DAC source
-54
Fatal error: EEPROM offset is out of range
-55
Fatal error: EEPROM gain is out of range
-56
Fatal error: Fail to set channel On
-57
Fatal error: Fail to set channel to Standby
-58
Fatal error: Channel generated a fault
-59
Fatal error: Channel must be set to ON prior calling this function
-60
Illegal timeout or not enough time to finish settings the specified voltage, try increasing the current limit.
-61
Error: Timeout reading the Analog to Digital convertor
-62
Error: Timeout setting the Digital to Analog to convertor voltage
-63
Error: Timeout setting the Digital to Analog to convertor current

 

User Calibration

-70
In-System-Calibration Error: Invalid load value, load value is out of the allowed range, see User's Guide for details
-71
In-System-Calibration Error: Illegal calibration sequence
-72
In-System-Calibration Error: Invalid Fixed Module type
-73
In-System-Calibration Error: Invalid voltage value
-74
Invalid Calibration By User step number
-75
Calibration did not start

 

Board Parameters Error

-80
Invalid DAQ Buffer Pointer Selection
-81
Invalid DAQ Buffer Count Selection
-82
Invalid HIRES Buffer Pointer Selection
-83
Invalid HIRES Buffer Count Selection
-84
Invalid Aperture Selection

Unknown Error Code

-99
Invalid or unknown error number

Example

The following example initializes the board. If the initialization failed, the following

error string is printed:

 

CHAR sz[256];

SHORT nStatus, nHandle;

GxPsInitialize (3, &Handle, &Status);

if (nStatus<0)

{   GxPdoGetErrorString(nStatus, sz, sizeof sz, &nStatus);

    printf(sz); // prints the error string returns

}