hidd_get_serial_number_string()

Get the serial number string

Synopsis:

#include <sys/hiddi.h>

int hidd_get_serial_number_string( struct hidd_connection *connection,
                                   struct hidd_device_instance *device_instance,
                                   void *buff,
                                   _Uint16t buff_len );

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.
buff
The pre-allocated memory buffer to store the serial number string.
buff_len
The length of the provided buffer in bytes.

Description:

The hidd_get_serial_number_string() function gets the serial number string from a device.

Note:
Some devices do not implement the serial number string descriptor.

Returns:

EOK
Success.
ENOTCONN
The connection is NULL.
EINVAL
The device_instance or buff is NULL.
ENODEV
The device was removed.
ENOTSUP
The device doesn't support getting the serial number string

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

Classification:

QNX OS

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