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_SendUnreliableBitmap</title>
9<LINK rel="stylesheet" href="../css/nitro.css" type="text/css">
10</head>
11
12<body>
13<a name="dwc__transport_8h_1d30a735ab4beb91f8923fa5d08bed597"></a>
14<h1 align="left">DWC_SendUnreliableBitmap</h1>
15<h2>Syntax</h2>
16
17<dl>
18  <dd>
19<CODE>#include &lt;dwc.h&gt;</CODE><BR>
20  <BR>
21  <PRE><CODE>u32 <a href=DWC_SendUnreliableBitmap.html#dwc__transport_8h_1d30a735ab4beb91f8923fa5d08bed597>DWC_SendUnreliableBitmap</a>(u32 bitmap,
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>bitmap</STRONG></EM></TD>
33<TD width="87%">Bitmap in which the AID bits for send destinations have been set.</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<p>Bitmap with bits set for the the AIDs for which send preparations were successfully finished. If this host's own AID bit was set when the bitmap was passed to the argument, the bit remains set.<br>There is a failure when an error occurs, an invalid AID is specified, or send data exceeds the maximum data size.</p>
52
53<H2>Description</H2>
54<p>After matchmaking completes, this function performs an Unreliable send using UDP to the AID bitmap specified in <CODE>bitmap</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 an Unreliable send is used to send more than this amount of data, the send will fail. 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 hosts. It only means that data was completely passed to a low-layer send function.</p><p>The AID bitmap of connected hosts can be retrieved with the <A href="DWC_GetAIDList.html"><CODE>DWC_GetAIDBitmap</CODE></A> function.</p><p>By using the <A href="DWC_SendUnreliable.html"><CODE>DWC_SendUnreliable</CODE></a> function, an Unreliable send can be made to a numerically specified AID.</p>
55
56<H2>Revision History</H2>
57<DL>
58
59</DL>
60<hr><p>CONFIDENTIAL</p></body>
61</html>
62