User Manual

PicoScope 4000 Series Programmer's Guide 51

4.10.32

ps4000OpenUnitEx

PICO_STATUS ps4000OpenUnitEx

(

short * handle,

char * 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, pointer to a short that receives the handle number:

-1 : if the unit fails to open,

0 : if no unit is found or

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

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

functions to identify this scope device.

serial, the serial number of the device to be opened. A null-

terminated string.

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