Previous

Next

Function RTUSuspendHubs

RTUSuspendHubs can be used to temporarily stop the hub class driver integrated in RTUSB-32:

void RTUSuspendHubs(int Suspend);

Parameters

Suspend

If not equal to zero, the hub class driver is suspended. If zero, it is resumed.

For correct operation, a thread should always call RTUSuspendHubs(1) and RTUSuspendHubs(0) in matching, non-nested pairs.

While the hub class driver is suspended, no hub messages are processed (rather, they are queued until the driver is continued). No attachment/detachment callbacks are called and no device handles are allocated or deallocated. Suspending the hub class driver is recommended while the application enumerates the device tree using RTUEnumDevices.

The length of time during which the driver is suspended should be as short as possible (i.e. no more than a few milliseconds). For example, if a device is removed while the hub driver is suspended, the respective driver will not be informed. Rather, the driver will continue to attempt to communicate with the removed device and receive many communication errors.

RTUSuspendHubs may not be called from an attachment/detachment callback.

Device Query

Function RTUParentDevice

Function RTUGetFrameNumber