Data Structures for Drivers                      usbifdescr(9S)



NAME
     usbifdescr - USB interface descriptor

SYNOPSIS
     #include 


INTERFACE LEVEL
     Solaris DI specific (Solaris DI)

DESCRIPTION
     The usbifdescrt interface descriptor  defines  attributes
     of an interface. A configuration contains one or more inter-
     faces. An interface contains one or more endpoints.


     Please refer to Section 9.6.5 of the USB 2.0  specification.
     The USB 2.0 specification is available at www.usb.org.


     One or more configuration descriptors are retrieved  from  a
     USB  device  during device enumeration. They can be accessed
     via usbgetdevdata(9F).


     A  interface descriptor has the following fields:

       uint8t     bLength                 Size of this descriptor
                                           in bytes.

       uint8t     bDescriptorType         Set to USBDESCRTYPEIF.

       uint8t     bInterfaceNumber        Interface number (0-based).

       uint8t     bAlternateSetting       Alternate setting number for
                                           this interface and its
                                           endpoints (0-based).

       uint8t     bNumEndpoints           Number of endpoints,
                                           excluding endpoint 0.

       uint8t     bInterfaceClass         Interface Class code
                                           (see below).

       uint8t     bInterfaceSubClass      Sub class code. (See USB 2.0
                                           specification of applicable
                                           interface class for information.)

       uint8t     bInterfaceProtocol      Protocol code.  (See USB 2.0
                                           specification of applicable
                                           interface class for information.)




SunOS 5.11           Last change: 5 Jan 2004                    1






Data Structures for Drivers                      usbifdescr(9S)



       uint8t     iInterface              Index of optional string
                                           describing this interface
                                           Valid if > 0. Pass to
                                           usbgetstringdescr(9F) to
                                           retrieve string.

       USB 2.0 specification interface descriptor bInterfaceClass field
       values are as follows:

               USBCLASAP           Application-specific interface class

               USBCLASAUDIO         Audio interface class

               USBCLASCID          Chip/Smartcard interface class

               USBCLASCDCTRL      CDC control interface class

               USBCLASCDCDATA      CDC data interface class

               USBCLASECURITY      Content security interface class

               USBCLASDIAG          Diagnostic interface class

               USBCLASHID           HID interface class

               USBCLASHUB           HUB interface class

               USBCLASMASTORAGE  Mass storage interface class

               USBCLASPHYSICAL      Physical interface class

               USBCLASPRINTER       Printer interface class

               USBCLASVENDORSPEC   Vendor-specific interface class

               USBCLASWIRELES      Wireless interface class




ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:












SunOS 5.11           Last change: 5 Jan 2004                    2






Data Structures for Drivers                      usbifdescr(9S)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Architecture                 PCI-based systems           
    
     Interface stability          Committed                   
    
     Availability                 SUNWusbu                    
    


SEE ALSO
     attributes(5),     usbgetaltif(9F),      usbgetcfg(9F),
     usbgetdevdata(9F),              usbgetstringdescr(9F),
     usbparsedata(9F), usbcfgdescr(9S), usbctrlrequest(9S),
     usbdevdescr(9S),  usbdevqlfdescr(9S), usbepdescr(9S),
     usbotherspeedcfgdescr(9S), usbstringdescr(9S)






































SunOS 5.11           Last change: 5 Jan 2004                    3