Platform SDK: DirectX

DPMSG_CREATEPLAYERORGROUP

The DPMSG_CREATEPLAYERORGROUP structure contains information for the DPSYS_CREATEPLAYERORGROUP system message. The system sends this message when players and groups are created in a session.

DirectPlay generates this message and sends it to each player when a new player or group is created in a session.

typedef struct{
    DWORD  dwType;
    DWORD  dwPlayerType;
    DPID   dpId;
    DWORD  dwCurrentPlayers;
    LPVOID lpData;
    DWORD  dwDataSize;
    DPNAME dpnName;
    DPID   dpIDParent;
    DWORD  dwFlags;
} DPMSG_CREATEPLAYERORGROUP, FAR *LPDPMSG_CREATEPLAYERORGROUP;
dwType
A DWORD that identifies the message. This member must be set to DPSYS_CREATEPLAYERORGROUP.
dwPlayerType
A DWORD that indicates whether the message applies to a player (DPPLAYERTYPE_PLAYER) or a group (DPPLAYERTYPE_GROUP).
dpId
ID of a player or group created.
dwCurrentPlayers
Number of players in the session.
lpData
Pointer to any application-specific, remote data associated with this player or group. If this member is NULL, there is no remote data.
dwDataSize
Size of the data contained in the buffer referenced by lpData.
dpnName
Structure containing the name of the player or group.
dpIDParent
ID of the parent group if this message is caused by a call to IDirectPlay4::CreateGroupInGroup; otherwise, the value is 0.
dwFlags
Player or group flags.
DPGROUP_HIDDEN
Set when a hidden group is created.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in dplay.h.

See Also

IDirectPlay4::CreateGroup, IDirectPlay4::CreatePlayer, IDirectPlay4::CreateGroupInGroup