DWC_SendUnreliable

Syntax

#include <dwc.h>

BOOL DWC_SendUnreliable( u8 aid, const void* buffer, int size );

Description

After matchmaking completes, this function performs an unreliable send to the connected party specified in aid.
Unreliable send is a UDP communication, so sent packets might be lost, or the send order might be switched, but errors are not returned in such cases. However, this method is faster than reliable send because there is no confirmation when the data arrives and there are no data resends.

Because the maximum size (by default, 1465 bytes) that can be sent in a single packet is fixed, data having a size greater than this cannot be sent using unreliable send. (Data is split up and then sent when using reliable send.) The maximum data size can be changed using the DWC_SetSendSplitMax function. To maintain compatibility with communication devices configured in various ways, avoid setting the size larger than the default.

When there is a send completion callback configured with the DWC_SetUserSendCallback function, the callback is called when the sending of data has finished.

A list of the AIDs of connected DS devices can be obtained using the DWC_GetAIDList function.

To make an unreliable send to multiple connected hosts at one time, use the DWC_SendUnreliableBitmap function.

Arguments

aid AID for the send destination.
buffer Pointer to send data.
size Size of the send data.

Return Values

TRUE Indicates that the data send has been accepted.
FALSE Indicates that the data send has not been accepted for any of the following reasons.
  • An error is being generated.
  • The AID is invalid.
  • An attempt was made to send data having a size greater than the maximum.

See Also

DWC_SendUnreliableBitmap
DWC_SendReliable
DWC_SendReliableBitmap
DWC_SetSendSplitMax
DWC_SetUserSendCallback
DWC_GetAIDList

Revision History

2008/04/24 Reviewed and revised the description because parts were hard to understand.
2007/12/29 Deleted the note regarding combined use with reliable send/receive.
2007/07/21 Added a note about combined use with reliable send/receive.
2006/02/22 Changed the description of return values to give more detail.
2005/12/16 Added a detailed function description.
2005/07/22 Initial version.


CONFIDENTIAL