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 http-equiv="Content-Style-Type" content="text/css">
7<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows">
8<title>DWC_SendUnreliable</title>
9<LINK rel="stylesheet" href="../css/nitro.css" type="text/css">
10</head>
11
12<body>
13<a name="dwc__transport_8h_1b95f23de902cbad010e65eea8051ab27"></a>
14<h1 align="left">DWC_SendUnreliable</h1>
15<h2>Syntax</h2>
16
17<dl>
18  <dd>
19<CODE>#include &lt;dwc.h&gt;</CODE><BR>
20  <BR>
21  <PRE><CODE>BOOL <a href=DWC_SendUnreliable.html#dwc__transport_8h_1b95f23de902cbad010e65eea8051ab27>DWC_SendUnreliable</a>(u8 aid,
22                        const void *buffer,
23                        int size);</CODE></PRE></dd>
24</dl>
25
26<h2>Arguments</h2>
27
28<TABLE border="1" width="100%">
29  <TBODY>
30
31    <TR>
32<TD width="13%"><EM><STRONG>aid</STRONG></EM></TD>
33<TD width="87%">AID of the send destination.</TD>
34    </TR>
35
36    <TR>
37<TD width="13%"><EM><STRONG>buffer</STRONG></EM></TD>
38<TD width="87%">Pointer to the send buffer.</TD>
39    </TR>
40
41    <TR>
42<TD width="13%"><EM><STRONG>size</STRONG></EM></TD>
43<TD width="87%">Size of the send buffer.</TD>
44    </TR>
45
46  </TBODY>
47</TABLE>
48
49<h2>Return Values</h2>
50
51<TABLE border="1" width="100%">
52  <TBODY>
53
54    <TR>
55<TD width="13%"><EM><STRONG>TRUE</STRONG></EM></TD>
56<TD width="87%">Storing the data in the send buffer succeeded.</TD>
57    </TR>
58
59    <TR>
60<TD width="13%"><EM><STRONG>FALSE</STRONG></EM></TD>
61<TD width="87%">Storing the data in the send buffer failed.<br>Either an error has occurred, an invalid AID has been specified, or there was an attempt to send more than the maximum data size.</TD>
62    </TR>
63
64  </TBODY>
65</TABLE>
66
67<H2>Description</H2>
68<p>After matchmaking completes, this function performs an Unreliable send using UDP to the AID specified in <CODE>aid</CODE>.</p><p>An Unreliable send is a UDP communication, so sent packets may be lost, or the send order may be switched. No error will be returned even if the sent data does not arrive. However, this method is fast because there is no confirmation when the data arrives and there are no data resends.</p><p>The maximum data size that can be sent at one time is determined In the DWC library (the default is 1465 bytes). If data larger than this is sent via an Unreliable send, the send fails and FALSE is returned. The maximum data size can be changed with the <A href="DWC_SetSendSplitMax.html"><CODE>DWC_SetSendSplitMax</CODE></A> function. To maintain compatibility with differently configured communication devices, avoid setting the size greater than the default.</p><p>If the <A href="DWC_SetUserSendCallback.html"><CODE>DWC_SetUserSendCallback</CODE></a> function is used to configure the send completion callback, and the send is successful, the callback is called before exiting this function. However, the send completion does not guarantee delivery to the other host. It only means that data was completely passed to a low-layer send function.</p><p>You can get the AIDs of the connected hosts using the <CODE><A href="DWC_GetAIDList.html">DWC_GetAIDList</A></CODE> function.</p><p>By using the <a href="DWC_SendUnreliableBitmap.html"><CODE>DWC_SendUnreliableBitmap</CODE></a> function, an Unreliable send can be done to multiple AIDs at one time.</p>
69
70<H2>Revision History</H2>
71<DL>
72
73</DL>
74<hr><p>CONFIDENTIAL</p></body>
75</html>
76