openusb_init, openusb_fini flags - Not used in this release. Reserved.
handle - Application should pass a valid address and upon successful
initialization of openusb_init, a openusb_handle will be returned
in it. This hanlde will be used by all operations related with
openusb instances.
Just like the name implies, the openusb_init()
initialize a openusb instance and sets up some internal structures for that
openusb instance. This function MUST be called before
any other openusb functions. It will load OS dependent backend and call
initialization function of that backend. It also scans for busses and
devices on the system.
Application should call openusb_fini() to destroy a openusb
instance when it finishes. openusb_fini() will destroy internal
structures associated with this instance. All handles associated with this
instance become invalid after the call to openusb_fini().
Upon successful initialization of a openusb instance, the openusb_init()
function will return OPENUSB_SUCCESS. Otherwise, a failure will be returned.
OPENUSB_PLATFORM_FAILURE -- Unspecified kernel/driver failure.
OPENUSB_BADARG -- An invalid argument is passed in. handle is invalid
OPENUSB_NO_RESOURCES -- Memory allocation failure.