Microsoft DirectX 8.0 (Visual Basic) |
アプリケーションとのピアの静的設定を設定する。アプリケーションに基本的なプレーヤー情報を転送するには、接続前にこのメソッドを呼び出す。ピアが正しくアプリケーションに接続すると、ほかのプレーヤーはこのメソッドで取得された情報を DirectPlay8Peer.GetPeerInfo メソッドを呼び出して取得できる。
SetPeerInfo(PlayerInfo As DPN_PLAYER_INFO) As Long
この処理に対する非同期ハンドルを返す。これは、要求が非同期で処理される場合に、要求を取り消すために DirectPlay8Peer.CancelAsyncOperation メソッドの lAsyncHandle パラメータで使用されるハンドルである。
失敗した場合は、Err.Number に次のいずれかの値が設定される。
DPNERR_NOCONNECTION |
DPNERR_INVALIDFLAGS |
DPNERR_INVALIDPARAM |
DirectPlay8Peer.SetPeerInfo メソッドを使用すると処理に負担がかかるため、非静的情報は DirectPlay8Peer.SendTo メソッドを使用して転送すること。
アプリケーションへの接続後、このメソッドを使用してピア情報を変更できる。接続後このメソッドが呼び出されると、DirectPlay は各プレーヤーの DirectPlay8Event.InfoNotify メソッドを呼び出して、プレーヤーにデータが更新されたことを通知する。