User Manual

Programming with the PicoScope 4000 Series94
Copyright © 2008-2011 Pico Technology Ltd. All rights reserved.ps4000pg.en
4.12
Driver error codes
This description of the driver error codes is aimed at those people who intend to
write their own programs for use with the driver. Every function in the ps4000.dll
driver returns an error code from the following list of PICO_STATUS values. They are
declared in the picoStatus.h header file supplied with the SDK.
Code
(hex)
Enum
00
PICO_OK. The PicoScope 4000 is functioning correctly.
01
PICO_MAX_UNITS_OPENED. An attempt has been made to open more than
PS4000_MAX_UNITS. (Reserved)
02
PICO_MEMORY_FAIL. Not enough memory could be allocated on the host machine.
03
PICO_NOT_FOUND. No PicoScope 4000 could be found.
04
PICO_FW_FAIL. Unable to download firmware.
05
PICO_OPEN_OPERATION_IN_PROGRESS. The driver is busy opening a device.
06
PICO_OPERATION_FAILED. An unspecified error occurred.
07
PICO_NOT_RESPONDING. The PicoScope 4000 is not responding to commands from
the PC.
08
PICO_CONFIG_FAIL. The configuration information in the PicoScope 4000 has
become corrupt or is missing.
09
PICO_KERNEL_DRIVER_TOO_OLD. The picopp.sys file is too old to be used with
the device driver.
0A
PICO_EEPROM_CORRUPT. The EEPROM has become corrupt, so the device will use a
default setting.
0B
PICO_OS_NOT_SUPPORTED. The operating system on the PC is not supported by this
driver.
0C
PICO_INVALID_HANDLE. There is no device with the handle value passed.
0D
PICO_INVALID_PARAMETER. A parameter value is not valid.
0E
PICO_INVALID_TIMEBASE. The time base is not supported or is invalid.
0F
PICO_INVALID_VOLTAGE_RANGE. The voltage range is not supported or is invalid.
10
PICO_INVALID_CHANNEL. The channel number is not valid on this device or no
channels have been set.
11
PICO_INVALID_TRIGGER_CHANNEL. The channel set for a trigger is not available on
this device.
12
PICO_INVALID_CONDITION_CHANNEL. The channel set for a condition is not
available on this device.
13
PICO_NO_SIGNAL_GENERATOR. The device does not have a signal generator.
14
PICO_STREAMING_FAILED. Streaming has failed to start or has stopped without
user request.
15
PICO_BLOCK_MODE_FAILED. Block failed to start - a parameter may have been set
wrongly.
16
PICO_NULL_PARAMETER. A parameter that was required is NULL.
17
PICO_ETS_MODE_SET. The function call failed because ETS mode is being
used.
18
PICO_DATA_NOT_AVAILABLE. No data is available from a run block call.
19
PICO_STRING_BUFFER_TOO_SMALL. The buffer passed was too small for the string
to be returned.
1A
PICO_ETS_NOT_SUPPORTED. ETS is not supported on this device variant.
1B
PICO_AUTO_TRIGGER_TIME_TOO_SHORT. The auto trigger time is less than the time
it will take to collect the data.
1C
PICO_BUFFER_STALL. The collection of data has stalled as unread data would be
overwritten.