.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "USB_ALTNUM_TO_ALTSETTING" "9" "09 October 2005" "" ""

.SH NAME
usb_altnum_to_altsetting \- get the altsetting structure with a given
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
struct usb_host_interface * usb_altnum_to_altsetting  (struct usb_interface * \fIintf\fB, unsigned int \fIaltnum\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIintf\fB\fR
the interface containing the altsetting in question
.TP
\fB\fIaltnum\fB\fR
the desired alternate setting number
.SH "DESCRIPTION"
.PP
This searches the altsetting array of the specified interface for
an entry with the correct bAlternateSetting value and returns a pointer
to that entry, or null.
.PP
Note that altsettings need not be stored sequentially by number, so
it would be incorrect to assume that the first altsetting entry in
the array corresponds to altsetting zero.  This routine helps device
drivers avoid such mistakes.
.PP
Don't call this function unless you are bound to the intf interface
or you have locked the device!
.SH "DESCRIPTION"
.PP
This searches the altsetting array of the specified interface for
an entry with the correct bAlternateSetting value and returns a pointer
to that entry, or null.
.PP
Note that altsettings need not be stored sequentially by number, so
it would be incorrect to assume that the first altsetting entry in
the array corresponds to altsetting zero.  This routine helps device
drivers avoid such mistakes.
.PP
Don't call this function unless you are bound to the intf interface
or you have locked the device!