Platform SDK: DirectX |
DirectPlayLobby3.RunApplication メソッドは、アプリケーションを開始し、そのアプリケーションをセッションに接続するために必要な情報をすべて渡す。このメソッドは、ロビー クライアントによって使用される。
object.RunApplication( _ connection As DirectPlayLobbyConnection, _ receiveEvent As Long) As Long
開始されたアプリケーションの ID を返す。ロビー クライアントは、このアプリケーション ID を保存して、DirectPlayLobby3.SendLobbyMessage メソッドおよび DirectPlayLobby3.ReceiveLobbyMessage メソッドの呼び出しで使用できるようにする必要がある。
失敗すればエラーが発生し、Err.Number に次のいずれかの値が設定される。
DPERR_CANTCREATEPROCESS |
DPERR_GENERIC |
DPERR_INVALIDINTERFACE |
DPERR_INVALIDOBJECT |
DPERR_INVALIDPARAMS |
DPERR_OUTOFMEMORY |
DPERR_UNKNOWNAPPLICATION |
このメソッドは、アプリケーション プロセスが作成された後に戻る。ロビー クライアントは、アプリケーションの状態を示すシステム メッセージを受信する。ロビー クライアントがセッションをホストするアプリケーションを起動している場合は、DPLSYS_DPLAYCONNECTSUCCEEDED システム メッセージを受信してから、そのセッションに参加するほかのアプリケーションを起動する必要がある。アプリケーションがセッションを作成または参加できなかった場合は、DPLSYS_DPLAYCONNECTFAILED メッセージが生成される。また、ロビー クライアントは、アプリケーションが接続設定を読み取ったときに DPLSYS_CONNECTIONSETTINGSREAD システム メッセージを受信し、アプリケーションが終了したときに DPLSYS_APPTERMINATED システム メッセージを受信する。
ロビー クライアントは、DPLSYS_CONNECTIONSETTINGSREAD システム メッセージを受信するまで、DirectPlayLobby3 オブジェクトを解放しないことが重要である。ロビー クライアントは、ReceiveLobbyMessage メッセージを受信するまでループで確認するか、または同期イベントを提供することができる。