<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >usb_bulk_msg</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK REL="HOME" TITLE="The Linux Kernel API" HREF="book1.html"><LINK REL="UP" TITLE="USB Devices" HREF="c12300.html"><LINK REL="PREVIOUS" TITLE="usb_control_msg" HREF="r12605.html"><LINK REL="NEXT" TITLE="16x50 UART Driver" HREF="c12756.html"></HEAD ><BODY CLASS="REFENTRY" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" >The Linux Kernel API</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="r12605.html" ACCESSKEY="P" ><<< Previous</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="c12756.html" ACCESSKEY="N" >Next >>></A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><H1 ><A NAME="AEN12691" ></A ><SPAN CLASS="phrase" ><SPAN CLASS="PHRASE" >usb_bulk_msg</SPAN ></SPAN ></H1 ><DIV CLASS="REFNAMEDIV" ><A NAME="AEN12695" ></A ><H2 >Name</H2 >usb_bulk_msg -- Builds a bulk urb, sends it off and waits for completion </DIV ><DIV CLASS="REFSYNOPSISDIV" ><A NAME="AEN12698" ></A ><H2 >Synopsis</H2 ><DIV CLASS="FUNCSYNOPSIS" ><A NAME="AEN12700" ></A ><P ></P ><P ><CODE ><CODE CLASS="FUNCDEF" >int <TT CLASS="FUNCTION" >usb_bulk_msg </TT ></CODE >(struct usb_device * <TT CLASS="PARAMETER" ><I >usb_dev</I ></TT >, unsigned int <TT CLASS="PARAMETER" ><I >pipe</I ></TT >, void * <TT CLASS="PARAMETER" ><I >data</I ></TT >, int <TT CLASS="PARAMETER" ><I >len</I ></TT >, int * <TT CLASS="PARAMETER" ><I >actual_length</I ></TT >, int <TT CLASS="PARAMETER" ><I >timeout</I ></TT >);</CODE ></P ><P ></P ></DIV ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN12716" ></A ><H2 >Arguments</H2 ><P ></P ><DIV CLASS="VARIABLELIST" ><DL ><DT ><TT CLASS="PARAMETER" ><I >usb_dev</I ></TT ></DT ><DD ><P > pointer to the usb device to send the message to </P ></DD ><DT ><TT CLASS="PARAMETER" ><I >pipe</I ></TT ></DT ><DD ><P > endpoint <SPAN CLASS="QUOTE" >"pipe"</SPAN > to send the message to </P ></DD ><DT ><TT CLASS="PARAMETER" ><I >data</I ></TT ></DT ><DD ><P > pointer to the data to send </P ></DD ><DT ><TT CLASS="PARAMETER" ><I >len</I ></TT ></DT ><DD ><P > length in bytes of the data to send </P ></DD ><DT ><TT CLASS="PARAMETER" ><I >actual_length</I ></TT ></DT ><DD ><P > pointer to a location to put the actual length transferred in bytes </P ></DD ><DT ><TT CLASS="PARAMETER" ><I >timeout</I ></TT ></DT ><DD ><P > time to wait for the message to complete before timing out (if 0 the wait is forever) </P ></DD ></DL ></DIV ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN12750" ></A ><H2 >Description</H2 ><P > This function sends a simple bulk message to a specified endpoint and waits for the message to complete, or timeout. </P ><P > If successful, it returns 0, othwise a negative error number. The number of actual bytes transferred will be plaed in the actual_timeout paramater. </P ><P > Don't use this function from within an interrupt context, like a bottom half handler. If you need a asyncronous message, or need to send a message from within interrupt context, use <TT CLASS="FUNCTION" >usb_submit_urb</TT > </P ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="r12605.html" ACCESSKEY="P" ><<< Previous</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="book1.html" ACCESSKEY="H" >Home</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="c12756.html" ACCESSKEY="N" >Next >>></A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><SPAN CLASS="phrase" ><SPAN CLASS="PHRASE" >usb_control_msg</SPAN ></SPAN ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="c12300.html" ACCESSKEY="U" >Up</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >16x50 UART Driver</TD ></TR ></TABLE ></DIV ></BODY ></HTML >