Scroll to navigation

USB_GSTRINGS_ATTACH(9) Kernel Mode Gadget API USB_GSTRINGS_ATTACH(9)

NAME

usb_gstrings_attach - attach gadget strings to a cdev and assign ids

SYNOPSIS

struct usb_string * usb_gstrings_attach(struct usb_composite_dev * cdev, struct usb_gadget_strings ** sp, unsigned n_strings);

ARGUMENTS

cdev
the device whose string descriptor IDs are being allocated and attached.

sp

an array of usb_gadget_strings to attach.

n_strings

number of entries in each usb_strings array (sp[]->strings)

DESCRIPTION

This function will create a deep copy of usb_gadget_strings and usb_string and attach it to the cdev. The actual string (usb_string.s) will not be copied but only a referenced will be made. The struct usb_gadget_strings array may contain multiple languages and should be NULL terminated. The ->language pointer of each struct usb_gadget_strings has to contain the same amount of entries. For instance: sp[0] is en-US, sp[1] is es-ES. It is expected that the first usb_string entry of es-ES contains the translation of the first usb_string entry of en-US. Therefore both entries become the same id assign.

AUTHOR

David Brownell <dbrownell@users.sourceforge.net>
Author.

COPYRIGHT

April 2019 Kernel Hackers Manual 4.9.