#include <dwc.h>
u32 DWC_SendUnreliableBitmap(u32 bitmap,
const void *buffer,
int size);bitmap |
Bitmap in which the AID bits for send destinations have been set. |
buffer |
Pointer to the send buffer. |
size |
Size of the send buffer. |
Bitmap with bits set for the the AIDs for which send preparations were successfully finished. If the local host's own AID bit was set when the bitmap was passed to the 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.
After matchmaking completes, this function performs an unreliable send using UDP to multiple AIDs indicated by the bitmap specified in bitmap.
An unreliable send is simply a UDP communication, so sent packets may be lost, or the send order may be switched. No error is 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.
This function can send a size up to DWC_TRANSPORT_SEND_UNRELIABLE_MAX (1462) bytes. The function returns FALSE if a size larger than this is specified.
If the DWC_SetUserSendCallback function has been used to configure a send completion callback, and the send is successful, the callback is called before exiting this function. However, the concept of "send complete" being used here indicates only that data has been fully passed to a low-level send function, not that data has arrived at the other host.
The AID bitmap of connected hosts can be retrieved with the DWC_GetAIDBitmap function.
By using the DWC_SendUnreliable function, an unreliable send can be made to a single host whose AID is specified numerically.
For the changelog prior to 5.1 PR2, click here.
CONFIDENTIAL