<?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_hcd_link_urb_to_ep</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /><link rel="home" href="index.html" title="The Linux-USB Host Side API" /><link rel="up" href="ch06.html" title="Chapter 6. Host Controller APIs" /><link rel="prev" href="re111.html" title="usb_calc_bus_time" /><link rel="next" href="re113.html" title="usb_hcd_check_unlink_urb" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center"><span>usb_hcd_link_urb_to_ep</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="re111.html">Prev</a> </td><th width="60%" align="center">Chapter 6. Host Controller APIs</th><td width="20%" align="right"> <a accesskey="n" href="re113.html">Next</a></td></tr></table><hr /></div><div class="refentry" title="usb_hcd_link_urb_to_ep"><a id="API-usb-hcd-link-urb-to-ep"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>usb_hcd_link_urb_to_ep —
add an URB to its endpoint queue
</p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" class="funcprototype-table"><tr><td><code class="funcdef">int <b class="fsfunc">usb_hcd_link_urb_to_ep </b>(</code></td><td>struct usb_hcd * <var class="pdparam">hcd</var>, </td></tr><tr><td> </td><td>struct urb * <var class="pdparam">urb</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1" title="Arguments"><a id="id3119192"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>hcd</code></em></span></dt><dd><p>
host controller to which <em class="parameter"><code>urb</code></em> was submitted
</p></dd><dt><span class="term"><em class="parameter"><code>urb</code></em></span></dt><dd><p>
URB being submitted
</p></dd></dl></div></div><div class="refsect1" title="Description"><a id="id3119241"></a><h2>Description</h2><p>
Host controller drivers should call this routine in their <code class="function">enqueue</code>
method. The HCD's private spinlock must be held and interrupts must
be disabled. The actions carried out here are required for URB
submission, as well as for endpoint shutdown and for usb_kill_urb.
</p><p>
Returns 0 for no error, otherwise a negative error code (in which case
the <code class="function">enqueue</code> method must fail). If no error occurs but <code class="function">enqueue</code> fails
anyway, it must call <code class="function">usb_hcd_unlink_urb_from_ep</code> before releasing
the private spinlock and returning.
</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="re111.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch06.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="re113.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>usb_calc_bus_time</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>usb_hcd_check_unlink_urb</span></td></tr></table></div></body></html>
