#include <vct.h>
int VCT_AddConferenceClient( u8 aid );
aid | AID of a client to be added. |
0 if successful; otherwise, the error code returns as a negative number.
VCT_AddConferenceClient adds a client to a conference. Specifying your own AID is not necessary and is ignored in the function. To start a conference, all clients must call this function. For example, three clients named AID 1, AID 2, and AID 3 enter into a conference. A client of AID 1 must specify AID 2 and AID 3, a client of AID 2 must specify AID 1 and AID 3, and a client of AID 3 must specify AID 1 and AID 2.
A conference's maximum number of clients is four players. Therefore, the maximum number of clients that can be added is three (this number excludes the user). In addition, the VCT_Init
function must be used to define the VCTSession
structure as the number of participating players minus one (X - 1 where X is the number of participating players). If the number of VCTSession structures specified by VCT_Init is less than the number of clients to be added, VCT_AddConferenceClient returns an error.
This function also returns an error if it is called in any mode other than Conference Mode.
VCT_RemoveConferenceClient,
VCTSession
2006/04/17 Error codes and a link of the VCTSession structure were added.
2006/03/28 A note regarding addition of client was added.
2006/01/25 First release