Platform SDK: DirectX |
DPLMSG_SETPROPERTY メッセージは、特定のプレーヤーのプロパティまたはセッションのプロパティが変更されたことをロビーに知らせるために、アプリケーションによりロビーに送信される。これらのプロパティには、プレーヤーのスコアや状態から、ゲームのカレント レベルやセッションの現在の状態までが含まれる。
typedef struct { DWORD dwType; DWORD dwRequestID GUID guidPlayer; GUID guidPropertyTag; DWORD dwDataSize; DWORD dwPropertyData[1]; } DPLMSG_SETPROPERTY, FAR *LPDPLMSG_SETPROPERTY;
各プロパティは、GUID (アプリケーション開発者またはロビー開発者により定義される) により識別される。さまざまなアプリケーションのプロパティ GUID からその記述やデータ タイプへのマッピングを保持するのは、ロビーの役割である。ロビー サーバーは、情報に基づいて処理するようにも、それを無視するようにも選択できる。
このメッセージを構成するとき、アプリケーションは DPLMSG_SETPROPERTY 構造体と完全なプロパティ データを保持するのに十分なメモリを割り当てる必要がある。たとえば、プロパティ データで 52 バイトが必要な場合、アプリケーションは (sizeof(DPLMSG_SETPROPERTY) + 52) バイトを割り当て、それを LPDPLMSG_SETPROPERTY ポインタに割り当てる。
Windows NT/2000 : Windows 2000 が必要。
Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
ヘッダー : dplobby.h で宣言。