Sophie

Sophie

distrib > Fedora > 18 > x86_64 > media > updates > by-pkgid > 1a595394b241504ff370a8d12ebfcea7 > files > 5087

kernel-doc-3.11.10-100.fc18.noarch.rpm

<?xml version="1.0" encoding="ANSI_X3.4-1968" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968" /><title>usb_altnum_to_altsetting</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1" /><link rel="home" href="index.html" title="The Linux-USB Host Side API" /><link rel="up" href="usbcore.html" title="Chapter&#160;5.&#160;USB Core APIs" /><link rel="prev" href="API-usb-ifnum-to-if.html" title="usb_ifnum_to_if" /><link rel="next" href="API-usb-find-interface.html" title="usb_find_interface" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center"><span class="phrase">usb_altnum_to_altsetting</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-usb-ifnum-to-if.html">Prev</a>&#160;</td><th width="60%" align="center">Chapter&#160;5.&#160;USB Core APIs</th><td width="20%" align="right">&#160;<a accesskey="n" href="API-usb-find-interface.html">Next</a></td></tr></table><hr /></div><div class="refentry"><a id="API-usb-altnum-to-altsetting"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>usb_altnum_to_altsetting &#8212; 
     get the altsetting structure with a given alternate setting number.
 </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">struct usb_host_interface * <strong class="fsfunc">usb_altnum_to_altsetting </strong>(</code></td><td>const struct usb_interface * <var class="pdparam">intf</var>, </td></tr><tr><td>&#160;</td><td>unsigned int <var class="pdparam">altnum</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div></div></div><div class="refsect1"><a id="idm140259811592704"></a><h2>Arguments</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term"><em class="parameter"><code>intf</code></em></span></dt><dd><p>
     the interface containing the altsetting in question
    </p></dd><dt><span class="term"><em class="parameter"><code>altnum</code></em></span></dt><dd><p>
     the desired alternate setting number
    </p></dd></dl></div></div><div class="refsect1"><a id="idm140259811587664"></a><h2>Description</h2><p>
   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.
   </p><p>

   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.
   </p><p>

   Don't call this function unless you are bound to the intf interface
   or you have locked the device!
</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-usb-ifnum-to-if.html">Prev</a>&#160;</td><td width="20%" align="center"><a accesskey="u" href="usbcore.html">Up</a></td><td width="40%" align="right">&#160;<a accesskey="n" href="API-usb-find-interface.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span class="phrase">usb_ifnum_to_if</span>&#160;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">&#160;<span class="phrase">usb_find_interface</span></td></tr></table></div></body></html>