Installation guide

ManualsBrandsC-SCOPE ManualsBusiness equipmentR1

API functions38

4.19

ps4000aGetUnitInfo

PICO_STATUS ps4000aGetUnitInfo

(

int16_t handle,

int8_t * string,

int16_t stringLength,

int16_t * requiredSize,

PICO_INFO info

)

This function writes information about the specified scope device to a character string.

If the device fails to open, only the driver version and error code are available to

explain why the last open unit call failed.

Applicability

All modes

Arguments

handle, the handle of the device from which information is

required. If an invalid handle is passed, the error code from the last

unit that failed to open is returned.

string, the character string buffer in the calling function where the

unit information string (selected with info) will be stored. If a null

pointer is passed, only requiredSize is returned.

stringLength, the size of the character string buffer.

* requiredSize, on exit, the required character string buffer size.

info, an enumerated type specifying what information is required

from the driver. Values are listed below.

Returns

PICO_OK

PICO_INVALID_HANDLE

PICO_NULL_PARAMETER

PICO_INVALID_INFO

PICO_INFO_UNAVAILABLE

PICO_INFO constant

Example

0: PICO_DRIVER_VERSION, version number of PicoScope 4000A

DLL

1,0,0,1

1: PICO_USB_VERSION, type of USB connection to device: 1.1 or

2.0

2: PICO_HARDWARE_VERSION, hardware version of device

3: PICO_VARIANT_INFO, variant number of device

4824

4: PICO_BATCH_AND_SERIAL, batch and serial number of device

KJL87/6

5: PICO_CAL_DATE, calibration date of device

11Nov13

6: PICO_KERNEL_VERSION, version of kernel driver

1,1,2,4