1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3<head>
4<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows">
6<META http-equiv="Content-Style-Type" content="text/css">
7<title>WBT_RequestSync</title>
8<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
9</head>
10
11<body>
12
13<h1 align="left">WBT_RequestSync&nbsp;<img src="../../image/NTR.gif"><img src="../../image/TWL.gif"></h1>
14<h2>Syntax</h2>
15
16<dl>
17  <dd>
18<CODE>#include &lt;nitro/wbt.h&gt;</CODE><BR> <BR> <CODE>BOOL WBT_RequestSync(u16 target, <A href="../wbt_callback_type.html">WBTCallback</A> callback);</CODE><br> <br>
19  </dd>
20</dl>
21<h2>Arguments</h2>
22<p>
23<TABLE border="1" width="100%">
24  <TBODY>
25    <TR>
26<TD width="13%"><CODE>target</CODE></TD>
27<TD width="87%">Target AID bitmap that synchronizes the parent and child. For the child, only the parent &quot;1&quot; can be specified.</TD>
28    </TR>
29    <TR>
30<TD width="13%"><CODE>callback</CODE></TD>
31<TD width="87%"><A href="../wbt_callback_type.html"><CODE>WBTCallback</CODE></A> format function that is notified when the command completes. This callback is called from inside the <a href="../child/WBT_MpChildRecvHook.html"><CODE>WBT_MpChildRecvHook</CODE></a> function.</TD>
32    </TR>
33  </TBODY>
34</TABLE>
35</p>
36
37<h2>Return Values</h2>
38<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>
39
40<H2>Description</H2>
41<p>Synchronizes communication with the specified target devices. Carries out this synchronization between parent and child, copying the send/receive packet size configured on the parent to the child.<br><br> <font color="#800000">The call fails if a command is still processing.</font><br> <br> <font color="#800000">Each child device calculates the transfer unit size and bitmap buffer size based on this size setting. Therefore, this function must be called at least once before calling the <A href="../command/WBT_GetBlock.html"><code>WBT_GetBlock</code></A> function.<br></font> <br>
42</p>
43<H2>See Also</H2>
44<A href="WBT_GetBlockInfo.html"><CODE>WBT_GetBlockInfo</CODE></A><BR> <A href="WBT_GetBlock.html"><CODE>WBT_GetBlock</CODE></A><BR> <A href="WBT_PutUserData.html"><CODE>WBT_PutUserData</CODE></A> <br>
45<H2>Revision History</H2>
46<P>
472005/06/01 Added text indicating that the callback is called from the <CODE>WBT_MpChildRecvHook</CODE> function.<br> 2004/09/21 Initial version.
48</P>
49<hr><p>CONFIDENTIAL</p></body>
50</html>
51