IDirectPlay8LobbyClient インターフェイス

[アーティクル]
04/22/2010

IDirectPlay8LobbyClient インターフェイス

アプリケーションは IDirectPlay8LobbyClient インターフェイスを使い、ローカルコンピュータでロビー対応ゲームの列挙と起動を行い、動作中のゲームと通信する。ロビークライアントは、ロビーおよびロビーされるゲームアプリケーションからのメッセージを処理するため、メッセージハンドラルーチンを登録する必要がある。

IDirectPlay8LobbyClient メンバ

Close	ロビークライアントを削除する。
ConnectApplication	ロビー対応アプリケーションを、DPL_CONNECT_INFO 構造体に指定されているセッションに接続する。アプリケーションが実行されていない場合、このメソッドを使ってアプリケーションを起動できる。接続が正しく確立されると、ロビーアプリケーションはメッセージハンドラに DPL_MSGID_CONNECT システムメッセージを送信する。
EnumLocalPrograms	システムに登録されているロビーアプリケーションを列挙する。
GetConnectionSettings	指定された接続の接続設定セットを取得する。これらの設定は、IDirectPlay8LobbyClient::ConnectApplication、IDirectPlay8LobbyClient::SetConnectionSettings、または IDirectPlay8LobbiedApplication::SetConnectionSettings のいずれかのメソッドの呼び出しによって設定できる。接続設定を取得すると、ユーザーに返される各アドレスオブジェクトに参照が追加される。したがって、構造体の処理が終了したら、ユーザーは各アドレスオブジェクトに対して Release を呼び出す必要がある。
Initialize	起動したアプリケーションの状態変更に関する通知を受け取るロビークライアントのコード内のエントリポイントを登録する。また、メッセージハンドラはロビーアプリケーションからメッセージを受け取る。このメソッドを呼び出してから、このインターフェイスのその他のメソッドを呼び出す必要がある。
ReleaseApplication	ロビーアプリケーションを解放し、ロビークライアントとアプリケーションの接続を終了する。ロビークライアントがアプリケーションとのセッションを終了するごとに、このメソッドを呼び出す必要がある。
Send	このロビークライアントによって起動または接続されたロビーアプリケーションにメッセージを送信する。このメソッドは、ターゲットのメッセージハンドラに DPL_MSGID_RECEIVE システムメッセージを送信する。
SetConnectionSettings	指定された接続に関連付ける接続設定を設定する。このメソッドを呼び出すと、hConnection で指定したクライアントに送信する DPL_MSGID_CONNECTION_SETTINGS メッセージが生成される。接続設定を設定すると、呼び出しに指定した各アドレスオブジェクトにロビーアプリケーションが参照を追加する。

インターフェイスの情報

継承元	IUnknown
ヘッダー	dplobby8.h
最低限のオペレーティングシステム	Windows 98、Pocket PC 2002