IDirectPlay8Peer インターフェイス
IDirectPlay8Peer インターフェイス
アプリケーションは、IDirectPlay8Peer インターフェイスのメソッドを使って、ピアツーピアの Microsoft® DirectPlay® セッションを作成する。
IDirectPlay8Peer メンバ
AddPlayerToGroup | グループにピアを追加する。 このメソッドを呼び出すと、アプリケーションに接続されているすべてのピアは DPN_MSGID_ADD_PLAYER_TO_GROUP メッセージを受信する。 |
CancelAsyncOperation | 非同期の要求を取り消す。たとえば、IDirectPlay8Peer インターフェイスのいくつかのメソッドはデフォルトでは非同期に実行される。状況に応じて、要求が処理される前にその要求を取り消したい場合もある。このインターフェイスで非同期に実行できるすべてのメソッドは、hAsyncHandle パラメータを返す。 要求の hAsyncHandle をこのメソッドの hAsyncHandle パラメータに渡すことによって、特定の要求が取り消される。このメソッドを呼び出し、hAsyncHandle パラメータに NULL を、dwFlags パラメータに DPNCANCEL_ALL_OPERATIONS を指定することによって、待機中のすべての非同期処理を取り消すことができる。特定のハンドルがこのメソッドに指定された場合は、いずれのフラグも設定してはならない。 |
Close | セッションへの接続を閉じ、IDirectPlay8Peer オブジェクトを未初期化する。いずれかのオブジェクトが IDirectPlay8Peer::Initialize で正常に初期化されると、このメソッドを呼び出す必要がある。 |
Connect | ピアツーピア セッションで、すべてのピアへの接続を確立する。一度接続が確立すると、インターフェイス上の通信チャンネルが開き、アプリケーションはメッセージの到着を待機する。接続が完了するまで、IDirectPlay8Peer::SendTo メソッドを使ってメッセージを送信できない。 |
CreateGroup | 現在のセッションにグループを作成する。グループはプレーヤの論理的な集まりである。 |
DestroyGroup | IDirectPlay8Peer::CreateGroup メソッドによって作成されたグループを削除する。このメソッドは、セッション内の任意のピアから呼び出すことができる。 |
DestroyPeer | セッションからピアを削除する。 |
EnumGroupMembers | グループ内のすべてのプレーヤの一覧を取得する。 |
EnumHosts | DirectPlay ゲームをホストするアプリケーションを列挙する。 |
EnumPlayersAndGroups | セッションのすべてのプレーヤまたはグループの識別子、あるいはその両方の一覧を取得する。 |
EnumServiceProviders | アプリケーションで利用できる登録済みサービス プロバイダをすべて列挙する。 |
GetApplicationDesc | 接続されたアプリケーションに関するアプリケーションの記述全体を取得する。 |
GetCaps | 現在のインターフェイスの DPN_CAPS または DPN_CAPS_EX 構造体を取得する。 |
GetConnectionInfo | ローカル アプリケーションと指定されたリモート プレーヤの接続に関する統計情報を取得する。 |
GetGroupContext | 指定されたグループのグループ コンテキスト値を取得する。 |
GetGroupInfo | グループ名など、グループに関連付けられているデータ ブロックを取得する。 通常、グループ データが変更されたことを示す DPN_MSGID_GROUP_INFO メッセージが受信された後、このメソッドが呼び出される。 |
GetLocalHostAddresses | セッションをホストするために使われるローカル アドレスを取得する。 |
GetPeerAddress | セッション内の指定されたリモート プレーヤのアドレスを取得する。 |
GetPeerInfo | 指定されたピアに設定されているピア情報を取得する。 |
GetPlayerContext | 指定されたピアのプレーヤのコンテキスト値を取得する。 |
GetSendQueueInfo | アプリケーションで送信キューのサイズを監視するために使う。 |
GetSPCaps | 指定されたサービス プロバイダの DPN_SP_CAPS 構造体を取得する。 |
Host | ローカル コンピュータがホストする、新しいピアツーピア セッションを作成する。 |
Initialize | IDirectPlay8Peer インターフェイスおよびリモート ピアからのメッセージをすべて受信する、ピアのコード内のエントリ ポイントを登録する。このメソッドを呼び出してから、このインターフェイスのその他のメソッドを呼び出す必要がある。 |
RegisterLobby | 起動したアプリケーションが、ゲームの状態を自動的にロビーに伝達できるようにする。 |
RemovePlayerFromGroup | グループからピアを削除する。 このメソッドが呼び出されると、アプリケーションに接続されているすべてのピアが DPN_MSGID_REMOVE_PLAYER_FROM_GROUP メッセージを受け取る。 |
ReturnBuffer | DPN_MSGID_RECEIVE システム メッセージの pReceiveData メンバによってアプリケーションに提供されるメッセージ バッファを取得する。ユーザーのメッセージ ハンドラが RECEIVE コールバックに DPNSUCCESS_PENDING を返した場合、バッファの所有権はアプリケーションに移行したと見なされ、この呼び出しにより所有権が DirectPlay に戻るまで所有権の解放や変更は行われない。 |
SendTo | 適切なメッセージ ハンドラにメッセージを送ることによって、セッション内の別のピアまたはグループにデータを送信する。メッセージは同期または非同期で送信できる。 |
SetApplicationDesc | ホストされているアプリケーションの設定を変更する。変更できるのは、いくつかの設定のみである。 |
SetCaps | 現在のインターフェイスの DPN_CAPS または DPN_CAPS_EX 構造体を設定する。 |
SetGroupInfo | グループ名など、グループに関連付けられているデータ ブロックを設定する。 このメソッドを呼び出すと、DPN_MSGID_GROUP_INFO メッセージが生成される。このメッセージは、アプリケーションに接続されているすべてのピアに送信される。 |
SetPeerInfo | ローカル ピアの静的設定を設定する。アプリケーションに基本的なプレーヤ情報を転送するには、接続前にこのメソッドを呼び出す。ピアが正しくアプリケーションに接続すると、他のプレーヤはこのメソッドで設定された情報を IDirectPlay8Peer::GetPeerInfo メソッドを呼び出して取得できる。 |
SetSPCaps | 指定されたサービス プロバイダに対する DPN_SP_CAPS 構造体を設定する。 |
TerminateSession | 現在の DirectPlay セッションを終了する。 |
インターフェイスの情報
継承元 | IUnknown |
ヘッダー | dplay8.h |
最低限のオペレーティング システム | Windows 98、Pocket PC 2002 |