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