NetworkSession.Create Method (NetworkSessionType, Int32, Int32, Int32, NetworkSessionProperties)
Starts hosting a new multiplayer session. This method blocks until the operation is complete.
Namespace: Microsoft.Xna.Framework.Net
Assembly: Microsoft.Xna.Framework.Net (in microsoft.xna.framework.net.dll)
Syntax
public static NetworkSession Create (
NetworkSessionType sessionType,
int maxLocalGamers,
int maxGamers,
int privateGamerSlots,
NetworkSessionProperties sessionProperties
)
Parameters
- sessionType
Type: NetworkSessionType
Type of session being hosted. - maxLocalGamers
Type: Int32
Maximum number of local players on the same gaming machine in this network session. - maxGamers
Type: Int32
Maximum number of players allowed in this network session. This value for games based on Windows or Xbox 360 must be between 2 and 31; 31 is the maximum number of players supported in a session. - privateGamerSlots
Type: Int32
Number of reserved private session slots created for the session. This value must be less than maxGamers. - sessionProperties
Type: NetworkSessionProperties
Properties of the session being created.
Return Value
The newly hosted session.
Exceptions
Exception type | Condition |
---|---|
ArgumentOutOfRangeException | One of the following conditions is true:
|
InvalidOperationException | One of the following conditions is true:
|
ObjectDisposedException | This NetworkSession is disposed. |
Remarks
The session continues even if one or more profiles sign out. Signed-out players are removed from the session, but the session ends only if no suitable players remain in the session.
Windows Specific Information |
---|
For Windows-based games, maxGamers must be between 2 and 31; 31 is the maximum number of players supported in a session. |
Xbox 360 Specific Information |
---|
For Xbox 360-based games, maxGamers must be between 2 and 31; 31 is the maximum number of players supported in a session. |
See Also
Reference
NetworkSession Class
NetworkSession Members
Microsoft.Xna.Framework.Net Namespace
Platforms
Xbox 360, Windows 7, Windows Vista, Windows XP