PicoScope 3000 Series User Guide
11
Copyright 2005 Pico Technology Limited. All rights reserved.
PS3000044 1.4
3.3.2
ps3000_get_unit_info
short ps3000_get_unit_info (
short
handle,
char
* string,
short
string_length,
short
info
)
This function writes oscilloscope information to a character string. If the oscilloscope fails
to open, only infos 0 and 6 are available to explain why the last open unit call failed.
Arguments
handle
, the handle to the device from which info is required. If an
invalid handle is passed, the error code from the last unit that failed to
open is returned from line 2.
* string
, a pointer to the character string buffer in the calling function
where the unit information string (selected with line) will be stored. If a
null pointer is passed, 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.
info
, is an enumerated type specifying what information is required
from the driver.
Returns
The length of the string written to the character string buffer, string, by
the function. If one of the parameters are out of range, or a null pointer
is passed for string, zero will be returned.
info
Description
Example
PS3000_DRIVER_VERSION
(0)
Returns the version number of the
DLL used by the oscilloscope driver.
"1, 0, 0, 2"
PS3000_USB_VERSION
(1)
Returns the type of USB connection
that is being used to connect the
oscilloscope to the computer.
"1.1" or "2.0"
PS3000_HARDWARE_VERSION
(2)
Returns information about what is
the hardware version of the attached
oscilloscope.
"1"
PS3000_VARIANT_INFO
(3)
Returns information about what
model of PicoScope 3000 Series PC
Oscilloscope is attached to the
computer.
"3206"
PS3000_BATCH_AND_SERIAL
(4)
Returns the batch and serial number
of the oscilloscope.
"CMY66/052"
PS3000_CAL_DATE
(5)
Returns the calibration date of the
oscilloscope.
"21Oct03"
PS3000_ERROR_CODE
(6)
.
"4"
