Platform SDK: DirectX |
DirectPlay4.CreatePlayer メソッドは、現在のセッションに対するローカル プレーヤーを作成する。
object.CreatePlayer(friendlyName As String, _ formalName As String, _ receiveEvent As Long, _ flags As CONST_DPPLAYERFLAGS) As Long
成功すれば、一意のプレーヤー ID を返す。
失敗すればエラーが発生し、Err.Number に次のいずれかの値が設定される。
DPERR_CANTADDPLAYER |
DPERR_CANTCREATEPLAYER |
DPERR_CONNECTIONLOST |
DPERR_INVALIDFLAGS |
DPERR_INVALIDPARAMS |
DPERR_NOCONNECTION |
単一のプロセスで、複数のローカル プレーヤーを持つことができる。これらのプレーヤーは、DirectPlay オブジェクトを介して、同じコンピュータ上のほかのプレーヤーや、リモート コンピュータ上のプレーヤーと通信する。
このメソッドは、適切に終了すると、DPSYS_CREATEPLAYERORGROUP システム メッセージをセッション内のすべてのプレーヤーに送信し、新しいプレーヤーがセッションに参加したことを伝える。デフォルトでは、すべてのローカル プレーヤーが、すべてのシステム メッセージのコピーを受信する。
アプリケーションでは、返されたプレーヤー ID を使用し、メッセージの送信やデータの関連付けのためにプレーヤーを識別する必要がある。DirectPlay によって割り当てられるプレーヤーとグループの ID は、セッション内では常に一意である。
以下のことを実行できるのは、プレーヤーを作成したアプリケーションだけである。
アプリケーションがセッションを閉じると、作成されたローカル プレーヤーは、自動的に破棄される。セッションのホストまたはプレーヤーを作成したアプリケーションは、DirectPlay4.DestroyPlayer メソッドを使用して、いつでもプレーヤーを破棄することができる。
DirectPlay4.GetDPEnumPlayers、DirectPlay4.GetPlayerFlags、DirectPlay4.Send、DirectPlay4.SetPlayerData、DirectPlay4.SetPlayerName、DirectX7.CreateEvent