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 |