Installation guide

PicoScope 4000 Series (A API) Programmer's Guide 51

4.32

ps4000aOpenUnit

PICO_STATUS ps4000aOpenUnit

(

int16_t * handle,

int8_t * serial

)

This function opens a scope device. The maximum number of units that can be opened

is determined by the operating system, the kernel driver and the PC's hardware.

Applicability

All modes

Arguments

handle, on exit, the handle of the device:

-1 : if the unit fails to open,

0 : if no unit is found or

> 0 : if successful (value is handle of the device opened)

The handle must be used in all subsequent calls to API functions to

identify this scope device.

* serial, on exit, a null-terminated string containing the device's

serial number.

Returns

PICO_OK

PICO_OS_NOT_SUPPORTED

PICO_OPEN_OPERATION_IN_PROGRESS

PICO_EEPROM_CORRUPT

PICO_KERNEL_DRIVER_TOO_OLD

PICO_FW_FAIL

PICO_MAX_UNITS_OPENED

PICO_NOT_FOUND

PICO_NOT_RESPONDING

PICO_USB3_0_DEVICE_NON_USB3_0_PORT