DWC_GetMatchingOption

Syntax

#include <dwc.h>

int DWC_GetMatchingOption( DWCMatchOptType opttype,
                           void* optval,
                           int*  optlen );

Description

This function gets the configurations for the matchmaking options features. Be sure to designate in optval the pointer used to store the data necessary for each of the options specified in opttype.

To configure the matchmaking options, the DWC_InitFriendsMatch function must be called and the FriendsMatch Library must be started. If the FriendsMatch Library is running, the matchmaking options can be configured with the DWC_SetMatchingOption function. The configured matchmaking options remain valid until the DWC_ShutdownFriendsMatch function is called to shut down the FriendsMatch Library.

The options are as follows:


opttype The optval type. Description
DWC_MATCH_OPTION_MIN_COMPLETE The DWCMatchOptMinComplete structure. For peer matchmaking, allows matchmaking for fewer than the number of people specified with the DWC_ConnectToAnybodyAsync and DWC_ConnectToFriendsAsync functions, even when matchmaking does not complete after a fixed amount of time. DWC_GetMOMinCompState function can be used to determine whether or not matchmaking still takes place within the specified amount of time.
DWC_MATCH_OPTION_SC_CONNECT_BLOCK BOOL On the server DS in server-client matchmaking, once a single client DS has successfully connected, no other connections will be accepted.
To start accepting connections again, call the DWC_ClearMOSCConnectBlock function. To determine whether or not connections are blocked, use the DWC_GetMOSCConnectBlockState function.
The DWC_ERROR_MO_SC_CONNECT_BLOCK error is generated for the client DS that is blocking connection requests.
optval indicates whether options are enabled (TRUE) or disabled (FALSE).

Arguments

opttype Option for matchmaking type. This is defined with DWC_MATCH_OPTION_*.
optval The pointer to where the matchmaking option configuration values are stored. Pass a pointer to the type that corresponds to opttype. Nothing is returned if the matchmaking options specified in opttype are not configured.
optlen The pointer to where the size of the value expressed in optval is stored. A zero is returned if the matchmaking options specified in opttype are not configured.

Return Values

DWC_SET_MATCH_OPT_RESULT_SUCCESS The matchmaking options were successfully obtained.
DWC_SET_MATCH_OPT_RESULT_E_BAD_STATE The FriendsMatch Library is not running.
DWC_SET_MATCH_OPT_RESULT_E_INVALID Invalid options have been specified in opttype.
DWC_SET_MATCH_OPT_RESULT_E_PARAM NULL was specified in optval.

See Also

DWC_SetMatchingOption
DWC_GetMOMinCompState
DWC_GetMOSCConnectBlockState
DWC_ClearMOSCConnectBlock
DWC_InitFriendsMatch
DWC_ShutdownFriendsMatch
DWC_ConnectToAnybodyAsync
DWC_ConnectToFriendsAsync
DWCMatchOptMinComplete

Revision History

2006/02/21 Added a description of optval.
2006/01/31 Included a link to the FriendsMatch Library.
2005/12/16 Initial version.


CONFIDENTIAL