Microsoft DirectX 9.0 SDK Update (Summer 2003) |
IDirectPlay8LobbiedApplication Interface
The IDirectPlay8LobbiedApplication interface is used by an application that supports lobbying. This interface allows the application to register with the system so that it can be lobby launched. Additionally, it also lets the application get the connection information necessary to launch a game without querying the user. Lastly, this interface allows the lobbied application to send messages and notifications to the lobby client that launched the application.
IDirectPlay8LobbiedApplication Members
Close Deletes the lobbied application.
GetConnectionSettings Retrieves the set of connection settings for the specified connection. These settings can be set through a call to the IDirectPlay8LobbyClient::ConnectApplication, IDirectPlay8LobbyClient::SetConnectionSettings, or IDirectPlay8LobbiedApplication::SetConnectionSettings method.
When you get connection settings, a reference will be added for each address object that is returned to the user. Therefore, users must be sure to call Release on each address object when they are done with the structure.
Initialize Registers a message handler function that receives notifications about changes in the state of the lobby client and receives messages from the lobby client.
RegisterProgram Registers a lobby-aware application with Microsoft® DirectPlay®. Applications must be registered to enable lobby launching.
Send Sends a message from the lobbied application to the lobby client.
SetAppAvailable Makes an application available or unavailable for a lobby client to connect to. This method is typically called if a lobbied application is independently launched, that is, not launched by a lobby client. Additionally, this method should be called if a game has ended and the lobbied application needs to be available to connect to a lobby client at the start of another game.
SetConnectionSettings Sets the connection settings to be associated with the specified connection. Calling this method generates a DPL_MSGID_CONNECTION_SETTINGS message to be sent to the client specified by hConnection.
When you set connection settings, the lobby application will add a reference to each of the address objects specified in the call.
UnRegisterProgram Unregisters a lobby-aware application that was registered through the IDirectPlay8LobbiedApplication::RegisterProgram method.
UpdateStatus Updates the status of a connected lobby client.
Interface Information
Inherits from IUnknown Header dplobby8.h Minimum operating systems Windows 98, Pocket PC 2002