USB_STRING_IDS_TAB

Section: Kernel Mode Gadget API (9)
Updated: February 2011
Index Return to Main Contents

NAME

usb_string_ids_tab - allocate unused string IDs in batch

SYNOPSIS

int usb_string_ids_tab(struct usb_composite_dev * cdev, struct usb_string * str);

ARGUMENTS

cdev

: the device whose string descriptor IDs are being allocated

str

: an array of usb_string objects to assign numbers to

CONTEXT

single threaded during gadget setup

DESCRIPTION

usb_string_ids() is called from bind callbacks to allocate string IDs. Drivers for functions, configurations, or gadgets will then copy IDs from the string table to the appropriate descriptors and string table for other languages.

All string identifier should be allocated using this, usb_string_id() or usb_string_ids_n() routine, to ensure that for example different functions don't wrongly assign different meanings to the same identifier.

AUTHOR

David Brownell <dbrownell@users.sourceforge.net>

: Author.