IDirectPlay8Server インターフェイス

IDirectPlay8Server インターフェイス

アプリケーションは、IDirectPlay8Server インターフェイスのメソッドを使って、Microsoft® DirectPlay® クライアント/サーバー トランスポート セッション用のサーバーを作成し、管理する。

IDirectPlay8Server メンバ

AddPlayerToGroup	グループにクライアントを追加する。クライアントがグループに正しく追加された後、グループに送信されるすべてのメッセージがクライアントに送信される。
CancelAsyncOperation	非同期の要求を取り消す。デフォルトでは、IDirectPlay8Server インターフェイスの多くのメソッドが非同期に実行される。状況に応じて、要求が処理される前にその要求を取り消したい場合もある。このインターフェイスで非同期に実行できるすべてのメソッドは、hAsyncHandle パラメータを返す。 要求の hAsyncHandle をこのメソッドの hAsyncHandle パラメータに渡すことによって、特定の要求が取り消される。このメソッドを呼び出し、hAsyncHandle パラメータに NULL を、dwFlags パラメータに DPNCANCEL_ALL_OPERATIONS を指定することによって、ペンディング状態のすべての非同期処理を取り消すことができる。特定のハンドルがこのメソッドに指定された場合は、いずれのフラグも設定してはならない。
Close	セッションへの開いた接続を閉じ、IDirectPlay8Server オブジェクトを未初期化する。
CreateGroup	現在のセッションにグループを作成する。このメソッドが呼び出されると、サーバーのメッセージ ハンドラが DPN_MSGID_CREATE_GROUP メッセージを受け取る。
DestroyClient	セッションからクライアントを削除する。
DestroyGroup	IDirectPlay8Server::CreateGroup メソッドによって作成されたグループを削除する。
EnumGroupMembers	グループ内のすべてのプレーヤのリストを取得する。
EnumPlayersAndGroups	アプリケーションのすべてのプレーヤまたはグループの識別子、あるいはその両方の識別子のリストを取得する。
EnumServiceProviders	アプリケーションで利用可能な登録済みサービス プロバイダを列挙する。
GetApplicationDesc	接続されたアプリケーションに関するアプリケーションの記述全体を取得する。
GetCaps	現在のインターフェイスの DPN_CAPS または DPN_CAPS_EX 構造体を取得する。
GetClientAddress	セッション内の指定されたプレーヤのアドレスを取得する。
GetClientInfo	指定されたクライアントに対して設定されているクライアント情報を取得する。
GetConnectionInfo	ローカル サーバーと指定されたリモート クライアントとの接続に関する統計情報を取得する。
GetGroupContext	グループに対するグループ コンテキスト値を取得する。
GetGroupInfo	グループ名など、グループに関連付けられているデータ ブロックを取得する。 通常、グループ データが変更されたことを示す DPN_MSGID_GROUP_INFO システム メッセージを受信した後、このメソッドを呼び出す。
GetLocalHostAddresses	セッションのホストになるために使われるローカル アドレスを取得する。
GetPlayerContext	クライアントに対するプレーヤ コンテキスト値を取得する。
GetSendQueueInfo	アプリケーションで送信キューのサイズを監視するために使う。DirectPlay では、受け取り側のコンピュータの処理速度よりも高速にメッセージを送信することはない。そのため、送信元のコンピュータが、送信先が受け取れる速さよりも高速にメッセージを送信した場合、メッセージは送信側のキューに蓄積される。アプリケーションにより、送信キューのサイズが大きすぎると登録された場合は、メッセージの送信レートを低下させる必要がある。
GetSPCaps	指定されたサービス プロバイダの DPN_SP_CAPS 構造体を取得する。
Host	ローカル コンピュータによってホストされる、新しいクライアント/サーバー セッションを作成する。
Initialize	IDirectPlay8Server インターフェイスおよびリモート クライアントからメッセージを受信する、サーバーのコード内のエントリ ポイントを登録する。このメソッドを呼び出してから、このインターフェイスのその他のメソッドを呼び出す必要がある。
RegisterLobby	起動したアプリケーションが、ゲームの状態を自動的にロビーに伝達できるようにする。
RemovePlayerFromGroup	グループからクライアントを削除する。
ReturnBuffer	DPN_MSGID_RECEIVE システム メッセージの pReceiveData メンバによってアプリケーションに提供されるメッセージ バッファを取得する。ユーザーのメッセージ ハンドラが RECEIVE コールバックに DPNSUCCESS_PENDING を返した場合、バッファの所有権はアプリケーションに移行したと見なされ、この呼び出しにより所有権が DirectPlay に戻るまで所有権の解放や変更は行われない。
SendTo	セッション内のクライアントまたはグループにデータを送信する。メッセージは同期または非同期で送信できる。
SetApplicationDesc	ホストされているアプリケーションの設定を変更する。変更できるのは、いくつかの設定のみである。
SetCaps	現在のインターフェイスの DPN_CAPS または DPN_CAPS_EX 構造体を設定する。
SetGroupInfo	グループ名など、グループに関連付けられているデータ ブロックを設定する。
SetServerInfo	アプリケーションでサーバーの静的設定を設定する。クライアントがサーバーに正しく接続されると、クライアントは IDirectPlay8Client::GetServerInfo メソッドを呼び出すことにより、このメソッドで設定された情報を取得できる。
SetSPCaps	指定されたサービス プロバイダに対する DPN_SP_CAPS 構造体を設定する。

インターフェイスの情報

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