Microsoft DirectX 8.0 (C++)

DPN_APPLICATION_DESC

Microsoft® DirectPlay® アプリケーションの設定を記述する。

typedef struct _DPN_APPLICATION_DESC{
    DWORD  dwSize;
    DWORD  dwFlags;
    GUID   guidInstance;
    GUID   guidApplication;
    DWORD  dwMaxPlayers;
    DWORD  dwCurrentPlayers;
    WCHAR* pwszSessionName;
    WCHAR* pwszPassword;
    PVOID  pvReservedData;
    DWORD  dwReservedDataSize;
    PVOID  pvApplicationReservedData;
    DWORD  dwApplicationReservedDataSize;
} DPN_APPLICATION_DESC, *PDPN_APPLICATION_DESC;

メンバ

dwSize
DPN_APPLICATION_DESC 構造体のサイズ。アプリケーションは、この構造体を使用する前に、まずこのメンバを設定する必要がある。
dwFlags
アプリケーションの動作を記述する次のいずれかのフラグ。
DPNSESSION_CLIENT_SERVER
このタイプのセッションはクライアント/サーバーである。このフラグを DPNSESSION_MIGRATE_HOST と組み合わせることはできない。
DPNSESSION_MIGRATE_HOST
ピアツーピア セッションで使用され、ホストの移行を可能にする。このフラグを DPNSESSION_CLIENT_SERVER と組み合わせることはできない。
DPNSESSION_NODPNSVR
DPNSVR からホストに列挙を転送しない。詳細については、「DirectPlay DPNSVR アプリケーションの使い方」を参照すること。
DPNSESSION_REQUIREPASSWORD
セッションをパスワードにより保護する。このフラグを設定した場合、pwszPassword に有効な文字列を指定する必要がある。
guidInstance
起動時に DirectPlay により生成され、このアプリケーションのインスタンスを表すグローバル ユニーク識別子 (GUID)。このメンバは、IDirectPlay8PeerIDirectPlay8Client、および IDirectPlay8Server インターフェイスで公開される GetApplicationDesc メソッドを呼び出すときの [out] パラメータである。また、IDirectPlay8Peer および IDirectPlay8Client インターフェイスで公開される Connect メソッドを呼び出すときの、オプションの [in] パラメータである。IDirectPlay8Server および IDirectPlay8Peer インターフェイスで公開される SetApplicationDesc メソッドを呼び出すときは、NULL に設定する必要がある。IDirectPlay8Server::Host または IDirectPlay8Peer::Host メソッドを呼び出してこの GUID を取得することはできない。GUID は GetApplicationDesc メソッドを呼び出して取得しなければならない。
guidApplication
アプリケーション GUID。
dwMaxPlayers
セッションで使用可能なプレーヤーの最大数を指定する DWORD 型の変数。プレーヤーの数を無制限にするときは、このメンバを 0 に設定する。
dwCurrentPlayers
セッションに現在接続されているプレーヤーの数を指定する DWORD 型の変数。このメンバは、IDirectPlay8PeerIDirectPlay8Client、および IDirectPlay8Server で公開される GetApplicationDescription メソッドによってのみ設定される [out] パラメータである。
pwszSessionName
セッションの Unicode™ 名を指定する WCHAR 型の変数へのポインタ。このメンバは、情報を伝えるだけの目的でホストまたはサーバーによって設定される。クライアントがこの名前を使用してホストまたはサーバーに接続することはできない。
pwszPassword
セッションへの接続に必要な Unicode パスワードを指定する WCHAR 型の変数へのポインタ。dwFlags メンバに DPNSESSION_REQUIREPASSWORD が設定されていない場合、この値は NULL にする必要がある。
pvReservedData
DirectPlay の予約済みデータへのポインタ。アプリケーションはこの値を変更してはならない。
dwReservedDataSize
pvReservedData メンバに保持されているデータのサイズを指定する DWORD 型の変数。アプリケーションはこの値を変更してはならない。
pvApplicationReservedData
アプリケーション固有の予約済みデータへのポインタ。この値はオプションであり、NULL に設定できる。
dwApplicationReservedDataSize
pvApplicationReservedData メンバのデータのサイズを指定する DWORD 型の変数。この値はオプションであり、NULL に設定できる。

注意

dwMaxPlayerspvApplicationReservedDatadwApplicationReservedDataSizepwszPassword、および pwszSessionName メンバは、IDirectPlay8Server および IDirectPlay8Peer インターフェイスで公開される Host または SetApplicationDesc メソッドを呼び出すときに設定できる。セッション中のプレーヤの現在の数より小さな値で dwMaxPlayers パラメータを設定することはできない。

動作環境

  Windows NT/2000 : Windows 2000 以降に対する再配布可能ファイルとして提供。
  Windows 95/98 : Windows 95 以降に対する再配布可能ファイルとして提供。
  ヘッダー : Dplay8.h で宣言。