#include <dwc.h>
u32 DWC_SendUnreliableBitmap( u32 bitmap,
const void* buffer,
int size );
After matchmaking completes, this function performs an Unreliable send via UDP to the AID bitmap specified in bitmap
.
An Unreliable send is a UDP communication, so sent packets may be lost, or the send order may be switched. No error will return, 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.
In the DWC library, the maximum data size that can be sent at one time is determined (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 DWC_SetSendSplitMax
function. To maintain compatibility with different communications devices, do not set the size above the default.
If the DWC_SetUserSendCallback 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 being referred to here is only for when data has been passed to a low-layer send function and does not mean when the data arrives at the communication partner.
The AID bitmap of a connected DS can be obtained with the DWC_GetAIDBitmap
function.
By using the DWC_SendUnreliable function, an Unreliable send can be made with multiple values assigned to an AID.
bitmap |
Bitmap in which the AID bits for send destination have been set. |
buffer |
Pointer to the send buffer. |
size |
Size of the send buffer. |
Bitmap in which the AID bits are set for successful transmission preparations. If the device's own AID bit is set and passed to an argument, the bit remains set.
There is a failure when an error occurs, an invalid AID is specified, or send data exceeds the maximum data size.
DWC_SendUnreliable, DWC_SendReliable, DWC_SendReliableBitmap, DWC_SetSendSplitMax, DWC_SetUserSendCallback, DWC_GetAIDBitmap
02/22/2006 Revised function description
12/16/2005 Added a more detailed description
11/02/2005 Initial version