hidd_device_reset()

Reset a device

Synopsis:

#include <sys/hiddi.h>

int hidd_device_reset( struct hidd_connection *connection,
                       struct hidd_device_instance *device_instance);

Arguments:

connection
The HID stack connection handle (from hidd_connect()).
device_instance

A pointer to a hidd_device_instance_t instance containing the number of the device to be reset.

Description:

The hidd_device_reset() function resets a hardware device.

CAUTION:
Proceed with caution when using hidd_device_reset(), in the case where the HID device is part of composite USB device. Issuing a device reset causes low level BUS reset for the entire device, which could potentially cause problems with drivers managing the other interfaces of a composite device.

Returns:

EOK
Success.
ENOTCONN
The connection is NULL.
EINVAL
The device_instance is NULL.
ENODEV
The device was removed.
ENOTSUP
The device doesn't support a reset.

This function can also return a device-specific error code.

Classification:

QNX OS

Safety:
Cancellation point Yes
Signal handler No
Thread Yes
Page updated: