NetworkSession.Create Method (NetworkSessionType, Int32, Int32, Int32, NetworkSessionProperties)

Starts hosting a new multiplayer session. This method blocks until the operation has completed.

Namespace: Microsoft.Xna.Framework.Net
Assembly: Microsoft.Xna.Framework (in microsoft.xna.framework.dll)

Syntax

public static NetworkSession Create (
         NetworkSessionType sessionType,
         int maxLocalGamers,
         int maxGamers,
         int privateGamerSlots,
         NetworkSessionProperties sessionProperties
)

Parameters

• sessionType
  Type of session being hosted.
• maxLocalGamers
  Maximum number of local players on the same gaming machine in this network session.
• maxGamers
  Maximum number of players allowed in this network session. For Windows- or Xbox 360-based games, this value must be between 2 and 31; 31 is the maximum number of players supported in a session. For Zune-based games, this value must be between 2 and 8; 8 is the maximum number of players supported in the session.
• privateGamerSlots
  Number of reserved private session slots created for the session. This value must be less than maxGamers.
• sessionProperties
  Properties of the session being created.

Return Value

The newly hosted session.

Exceptions

Exception type	Condition
ArgumentOutOfRangeException	One of the following conditions is true: maxGamers is not in range of gamers that are supported in a network session. The XNA Framework supports multiplayer sessions between 2 and 31 players in a session for a Windows- or an Xbox 360-based game. On Zune, the XNA Framework supports a multiplayer session between 2 and 8 players in a session. privateGamerSlots is less than 0 or greater than maximumGamers.
InvalidOperationException	One of the following conditions is true: A different session already exists. There can only be one NetworkSession or AvailableNetworkSessionCollection in use at a time. You must dispose any previous session before you create a new one. One of the following methods has been called, but has not yet returned results: NetworkSession.Create NetworkSession.BeginCreate NetworkSession.Find NetworkSession.BeginFind NetworkSession.Join NetworkSession.BeginJoin Note that you must wait for any of these methods to return before you can create a new network session. To support this, you may use the asynchronous methods BeginCreate, BeginFind, BeginJoin, and the corresponding EndCreate, EndFind, EndJoin methods to detect when the operation is complete.
ObjectDisposedException	This NetworkSession is disposed.

Remarks

Zune Specific Information
For Zune-based games, maxGamers must be between 2 and 8; 8 is the maximum number of players supported 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.

Behavior of Local Sessions

XNA Game Studio 3.0 introduces a change in the behavior of network sessions when local profiles sign out in the middle of a session. In previous versions of XNA Game Studio, a session would end whenever a player signed out. Now, profiles that sign out are removed from the session, and the session will be ended only if there are no suitable players left in the session.

See Also

Reference

NetworkSession Class
NetworkSession Members
Microsoft.Xna.Framework.Net Namespace

Platforms

Xbox 360, Windows XP SP2, Windows Vista, Zune