API Functions24
Copyright © 2006–2016 Pico Technology Ltd. All rights reserved.ps2000pg.en r11
5.8
ps2000_get_unit_info
int16_t ps2000_get_unit_info
(
int16_t handle,
int8_t *string,
int16_t string_length,
int16_t line
)
This function writes oscilloscope information to a character string. If the oscilloscope
failed to open, only line types 0 and 6 are available to explain why the last open unit
call failed.
handle: the handle of the oscilloscope from which information is
required. If an invalid handle is passed, the error code from the last
oscilloscope that failed to open is returned.
string: a pointer to the character string buffer in the calling
function where the function will write the oscilloscope information
string selected with line. If string is NULL, no information will be
written.
string_length: the length of the character string buffer. If the
string is not long enough to accept all of the information, only the
first string_length characters are returned.
line: a value selected from enumerated type PS2000_INFO (see
table below) specifying what information is required from the driver
The length of the string written to the string buffer
0: if one of the parameters is out of range or string is NULL
PS2000_DRIVER_VERSION (0), the version number of the
DLL used by the oscilloscope driver.
PS2000_USB_VERSION (1), the type of USB connection that
is being used to connect the oscilloscope to the computer.
PS2000_HARDWARE_VERSION (2), the hardware version of
the attached oscilloscope.
PS2000_VARIANT_INFO (3), the variant of PicoScope 2000
PC Oscilloscope that is attached to the computer.
PS2000_BATCH_AND_SERIAL (4), the batch and serial
number of the oscilloscope.
PS2000_CAL_DATE (5), the calibration date of the
oscilloscope.
PS2000_ERROR_CODE (6), one of the Error codes.
PS2000_KERNEL_DRIVER_VERSION (7), the version
number of the kernel driver.