DWC_GetAIDList

Syntax

#include <dwc.h>

int DWC_GetAIDList( u8** aidList );

Description

This function gets the pointer to the connected host's AID list (does not copy).

AID is a device ID between 0 and the number of devices making up the network minus 1; this ID identifies each DS in the mesh-type network. For example, if four people have completed matchmaking, there are four devices: 0, 1, 2, and 3. If the person whose device uses AID 1 leaves the network, the remaining devices will be 0, 2, and 3.

For server-client matchmaking, the AID for the server DS will always be 0.

To get the AID of the connected host as a bitmap, use the DWC_GetAIDBitmap function.

Arguments

aidList Pointer to the AID list.

Return Values

Returns the number of connected hosts, including this host. If this function is called when the FriendsMatch Library is not running, a 0 will be returned.

See Also

DWC_GetMyAID
DWC_GetAIDBitmap

Revision History

2006/02/22 Added description of AID during server-client matchmaking.
2006/01/31 Devised the Return Values section with information on the FriendsMatch Library.
2005/12/16 Added AID and return value descriptions.
2005/07/22 Initial version.


CONFIDENTIAL