DWC_SendUnreliableBitmap

C Specification

#include <dwc.h>

u32 DWC_SendUnreliableBitmap( u32 bitmap,
                              const void* buffer,
                              int size );

Description

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.

Arguments

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.

Return Values

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.

See Also

DWC_SendUnreliable, DWC_SendReliable, DWC_SendReliableBitmap, DWC_SetSendSplitMax, DWC_SetUserSendCallback, DWC_GetAIDBitmap

Revision History

02/22/2006 Revised function description
12/16/2005 Added a more detailed description
11/02/2005 Initial version