User manual

USB DrDAQ Programmer's Guide 13

3.5.4

UsbDrDaqGetUnitInfo

PICO_STATUS UsbDrDaqGetUnitInfo(

short handle,

char * string,

short stringLength,

short * requiredSize,

PICO_INFO info

)

This function returns a string containing the specified item of information about the

unit.

If you want to find out the length of the string before allocating a buffer for it, then

call the function with string = NULL first.

Arguments:

handle: handle returned from UsbDrDaqOpenUnit or

UsbDrDaqOpenUnitProgress

string: a location where the function writes the requested

information, or NULL if you are only interested in the value of

requiredSize

stringLength: the maximum number of characters that the

function should write to string

requiredSize: a location where the function writes the length of

the information string before it was truncated to stringLength. If

the string was not truncated then requiredSize will be less than or

equal to stringLength.

info: the information that the driver should return. These values are

specified in picoStatus.h:

PICO_DRIVER_VERSION

PICO_USB_VERSION

PICO_HARDWARE_VERSION

PICO_VARIANT_INFO

PICO_BATCH_AND_SERIAL

PICO_CAL_DATE

PICO_KERNEL_DRIVER_VERSION

Returns:

PICO_OK

PICO_INVALID_HANDLE

PICO_NULL_PARAMETER

PICO_INVALID_INFO

PICO_INFO_UNAVAILABLE