User Manual

Programming with the PicoScope 4000 Series34
Copyright © 2008-2011 Pico Technology Ltd. All rights reserved.ps4000pg.en
4.10.15
ps4000GetUnitInfo
PICO_STATUS ps4000GetUnitInfo
(
short handle,
char * string,
short stringLength,
short * 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, a pointer to 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 the requiredSize,
pointer to a short, of the character string buffer is returned.
stringLength, used to return the size of the character string
buffer.
requiredSize, used to return the required character string buffer
size.
info, an enumerated type specifying what information is required
from the driver.
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 4000 DLL
1,0,0,1
1: PICO_USB_VERSION, type of USB connection to device: 1.1 or
2.0
2.0
2: PICO_HARDWARE_VERSION, hardware version of device
1
3: PICO_VARIANT_INFO, variant number of device
4224
4: PICO_BATCH_AND_SERIAL, batch and serial number of device
KJL87/6
5: PICO_CAL_DATE, calibration date of device
11Nov08
6: PICO_KERNEL_VERSION, version of kernel driver
1,1,2,4