TSI Incorporated 8587A, Руководство по эксплуатации и обслуживанию

Страница: 72 / 85

C-4 Model 8587A Laser Photometer
USB Command Status Errors
A function is provided that converts USB status codes into the appropriate
error string. This function is TsiUsbGetStatusString().
Within the DLL most pStatus codes are initialized to 0xffff. If a pStatus is
returned with 0xffff, it is probable that a Win32 error occurred.
The defined TSI USB status codes are as follows
USB_OK
0x0000
USB_ERROR_CMD_INVALID 0x0001
USB_ERROR_CMD_LENGTH 0x0002
USB_ERROR_DATALENGTH_INVALID 0x0005
USB_STATUS_BUSY 0x0006
USB_ERROR_BUFFER_LENGTH 0x000c
USB_ERROR_BUFFER_FULL 0x0011
D e v i c e O p e r a t i o n
When working with the TsiUsb driver and the TsiUsbApi DLL the normal
device communication operation is as follows:
1. Use ListDevices() to determine the number and symbolic links of TSI
USB devices attached to the system. The symbolic link is the unique
USB device name.
2. Use DeviceOpen() sending the symbolic link attained from
ListDevices() to open a connection to the device.
3. Using the set of functions described in the following section labeled
“Communicating with the attached device.” Use the functions
necessary for performing the device communication that is required by
your application.
4. Use DeviceClose() to close the connection to the device.
It is best to open and close the device often rather than open the device
once and close the device once, over a long period. The device USB
connection can be unplugged during device operation. The Driver and DLL
will handle this.