beautypg.com

Usb_tc08_open_unit_progress, Handle, &progress) – Omega Speaker Systems 8 Channel Thermocouple USB Data Acquisition Module TC-08 User Manual

Page 24

background image

TC-08 User's Guide

20

3.3.2.3

usb_tc08_open_unit_progress

short usb_tc08_open_unit_progress
(

short * handle,
short * progress

)

Call this function after

usb_tc08_open_unit_async

. Repeatedly call it to determine

the state of the background enumeration process. For an example of usage, see

usb_tc08_open_unit_async

.

Arguments

handle

(Out) A handle (positive short) to the unit if the enumeration
is completed. Handle will always be 0 if the enumeration is
incomplete.

progress

(Out) (Optional - can pass NULL) returns a number from 0 to
100 representing the percentage completion of the
enumeration of one unit.

Returns

-1
USBTC08_PROGRESS_FAIL

An error occurred, call

usb_tc08_get_last_error

with a

handle of 0 to obtain the error code.

0
USBTC08_PROGRESS_PENDING

Enumeration has not completed
(keep calling
usb_tc08_open_unit_progress).

1
USBTC08_PROGRESS_COMPLETE

Enumeration has completed and the
handle is now valid.