<?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 5. 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> </td><th width="60%" align="center">Chapter 5. USB Core APIs</th><td width="20%" align="right"> <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 — 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> </td><td>unsigned int <var class="pdparam">altnum</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </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> </td><td width="20%" align="center"><a accesskey="u" href="usbcore.html">Up</a></td><td width="40%" align="right"> <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> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span class="phrase">usb_find_interface</span></td></tr></table></div></body></html>