Returns the error string associated with the specified error number.
GxPdoGetErrorString (nError, pszMsg, nErrorMaxLen, pnStatus)
Name |
Type |
Description |
nError |
SHORT |
Handle for the PXI board. |
pszMsg |
PSTR |
Buffer to the returned error string. |
nErrorMaxLen |
SHORT |
The size of the error string buffer. |
pnStatus |
PSHORT |
Returned status: 0 on success, negative number on failure. |
The function returns the error string associated with the nError as returned from other driver functions by the pnStatus parameter.
The following table displays the possible error values; not all errors apply to this board type:
Warnings
12 Measurement Value is out of range
11 Unable to find suitable filter value AutoFilter mode
10 Measurement timeout, no signal was detected. Timeout value needs to be greater than Gate Time
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
VISA Errors
-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
Misc Errors
-38 Unable to lock a board resource, resource is used by another process or thread
Parameter Errors
-40 Invalid channel number, channels numbers are 0-7
-41 Invalid channel rail, channel's rail may be Rail A-C or Open
-42 Invalid DAC number, DAC numbers are 0-2
-43 Invalid DAC voltage value
-44 Invalid rail number, Rail numbers are 1-3
-45 Invalid Rail source, Rail source is not supported by the specified Rail.
-46 Invalid gain value
-47 Invalid offset value
-50 EEPROM Busy Timeout
Board/execution error
-60 Unable to set DAC value
Calibration errors
-80 Calibration by user, sequence error
-81 Calibration by user, invalid calibration data
-82 Calibration by user, invalid load value
-83 Calibration by user, change calibration source
The following example initializes the board. If the initialization failed, the following error string is printed:
CHAR sz[256];
SHORT nStatus, nHandle;
Gx3348Initialize (3, &Handle, &Status);
if (nStatus<0)
{ GxPdoGetErrorString(nStatus, sz, sizeof sz, &nStatus);
printf(sz); // prints the error string returns
}