1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3
4<head>
5<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
6<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows">
7<META http-equiv="Content-Style-Type" content="text/css">
8<title>WBT_PutUserData</title>
9<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
10</head>
11
12<body>
13
14<h1 align="left">WBT_PutUserData&nbsp;<img src="../../image/NTR.gif"><img src="../../image/TWL.gif"></h1>
15<h2>Syntax</h2>
16
17<dl>
18  <dd>
19<CODE>#include &lt;nitro/wbt.h&gt;</CODE><BR> <BR> <CODE>BOOL WBT_PutUserData(u16 target, const void *user_data, int size, <A href="../wbt_callback_type.html">WBTCallback</A> callback);</CODE><br> <br>
20  </dd>
21</dl>
22<h2>Arguments</h2>
23<p>
24<TABLE border="1" width="100%">
25  <TBODY>
26    <TR>
27<TD width="13%"><CODE>target</CODE></TD>
28<TD width="87%">Target AID bitmap that sends data. When child, only parent <code>1</code> can be specified.</TD>
29    </TR>
30    <TR>
31<TD width="13%"><CODE>user_data</CODE></TD>
32<TD width="87%">Buffer where send data is stored. This buffer is copied to separate memory during the function call, so you can use it freely after this function.</TD>
33    </TR>
34    <TR>
35<TD width="13%"><CODE>size</CODE></TD>
36<TD width="87%">Send size of the data. Any size less than <a href="../wbt_size_user_data_const.html"><CODE>WBT_SIZE_USER_DATA</CODE></a> can be specified.</TD>
37    </TR>
38    <TR>
39<TD width="13%"><CODE>callback</CODE></TD>
40<TD width="87%"><A href="../wbt_callback_type.html"><CODE>WBTCallback</CODE></A> format function that receives notifications when commands are completed. This callback is called from within the <a href="../parent/WBT_MpParentRecvHook.html"><CODE>WBT_MpParentRecvHook</CODE></a> or <a href="../child/WBT_MpChildRecvHook.html">WBT_MpChildRecvHook</CODE></a> function.
41</TD>
42    </TR>
43  </TBODY>
44</TABLE>
45</p>
46
47<h2>Return Values</h2>
48<p>If no command is currently processing, the function issues a command and returns <CODE>TRUE</CODE>. Otherwise, the function does nothing and returns <CODE>FALSE</CODE>.</p>
49
50<H2>Description</H2>
51<p>Sends an arbitrary small-scale data block to the specified target device.<br> <font color="#800000">The call fails if a command is still processing.</font> <br>
52</p>
53<H2>See Also</H2>
54<p>
55<A href="WBT_RequestSync.html"><CODE>WBT_RequestSync</CODE></A><BR> <A href="WBT_GetBlockInfo.html"><CODE>WBT_GetBlockInfo</CODE></A><BR> <A href="WBT_GetBlock.html"><CODE>WBT_GetBlock</CODE></A>
56</p>
57<H2>Revision History</H2>
58<P>
592006/03/13 Revised description of target argument.<br>2005/06/01 Added text indicating that the callback is called from the <CODE>WBT_MpParentRecvHook</CODE> or <CODE>WBT_MpChildRecvHook</CODE> function.<br> 2004/09/31 Initial version.
60</P>
61<hr><p>CONFIDENTIAL</p></body>
62</html>
63