#include <dwc.h>
u32 DWC_SendReliableBitmap( u32 bitmap, const void* buffer, int size );
After matchmaking completes, this function performs a reliable send to the party having the AID specified in bitmap.
Although UDP is used for the reliable send, it is implemented at the library level so that data reaches the other party in the order sent without duplication or loss of packets. In return, it becomes necessary to check the arrival of packets for each send; be aware that this takes longer than an unreliable send, which does not perform this type of check.
Because data sent using this function is temporarily stored as described below, do not change the contents of the send data (buffer) during this period.
To find out whether it is okay to change the content of send data, either use the DWC_IsSendableReliable function to confirm that a reliable send is possible or check that the send is complete using the send completion callback described below.
DWC_InitFriendsMatch function until arrival at the destination host is confirmed. If there is insufficient memory in this buffer, data not entered into the buffer is temporarily stored and sent from within the DWC_ProcessFriendsMatch function in sequential order as memory in the buffer is freed.
DWC_ProcessFriendsMatch function.DWC_SetSendSplitMax function. To maintain compatibility with communication devices configured in various ways, avoid setting the size larger than the default.
Furthermore, when a send completion callback has been configured with the DWC_SetUserSendCallback function, the callback is called when the sending of data has finished. However, the concept of "send complete" being used here indicates that data has been stored in the send buffer, not that data has arrived at the other host.
A list of the AIDs of connected DS devices can be obtained using the DWC_GetAIDList function.
By using the DWC_SendReliable function, a reliable send can be made to any given connected DS.
bitmap |
Bitmap in which the AID bits for send destinations have been set. |
buffer |
Pointer to send data. |
size |
Size of the send data. |
Returns a bitmap for which the AID bits of hosts accepting a data send have been set. However, if the local host's own AID bit has been set as a send destination, the data send will not be accepted, but the corresponding bit in the return value will be set.
Data sends might not be accepted for the following reasons.
DWC_SendReliable
DWC_SendUnreliable
DWC_SendUnreliableBitmap
DWC_InitFriendsMatch
DWC_ProcessFriendsMatch
DWC_SetSendSplitMax
DWC_IsSendableReliable
DWC_SetUserSendCallback
DWC_GetAIDBitmap
2008/04/24 Reviewed and revised the description because parts were hard to understand.
2007/12/29 Deleted the note regarding combined use with unreliable send/receive.
2007/07/21 Added a note about combined use with unreliable send/receive.
2006/05/22 Revised the description of errors.
2006/02/22 Revised the function description.
2005/12/16 Added a detailed function description.
2005/11/14 Added a description of reliable sends.
2005/11/02 Initial version.
CONFIDENTIAL