Welcome to
www.tdxlibrary.org
Home of the
the TDx_Library...
"RAD DirectX"
for
C++ Builder
...
- Description
The CreatePlayer method will create a local player within the session.
CreatePlayer will generate a DPMSG_CREATEPLAYERORGROUP message informing other players in the session about the new player.
Only the creating application may send messages for the player or change the players name and data.
TDx_Play::DestroyPlayer() may be used by the creating application or session host to destroy a player. All local players will be automatically destroyed if the session is closed.
Error values that can be generated are:
DPERR_CANTADDPLAYER
DPERR_CANTCREATEPLAYER
DPERR_CONNECTIONLOST
DPERR_INVALIDFLAGS
DPERR_INVALIDPARAMS
DPERR_NOCONNECTION
- Parameters
Player
The Player parameter will reference the new players ID if this method returns successfully.
PlayerName
The PlayerName parameter references a TDPName component holding the new players name.
The name is assigned and used by the application, it need not be unique and NULL can be set if no player name is required.
Data
The Data parameter references data to be propagated once the player is created as if TDx_Play::SetPlayerData() had been called.
The data is application defined and this parameter may be set to NULL if no initial data is needed.
DataSize
The DataSize parameter defines the size, in bytes, of the data referenced by the Data parameter.
Flags
The Flags parameter defines flags indicating the player type to be created.
The described effect applies when the flag is set.
Setting zero will result in a nonspectator, nonserver player.
-
DPPLAYER_SERVERPLAYER
The player is to be the server player in a client server session.
Only one server player may exist per session and it must be created by the host.
The player ID will always be DPID_SERVERPLAYER when this flag is set.
DPPLAYER_SPECTATOR
The player is designated a spectator player.
The application must define spectator behaviour, the player behaves normally other than having this flag set.
- See Also
- Top
TDx_Play_Library v2.00 Component Reference
|
|
|
[ TDx_Play::CreatePlayer() ] [ next: DeleteGroupFromGroup() ] [ prev: CreateGroupInGroup() ] public:
virtual bool __fastcall CreatePlayer( DPID* pPlayer, TDPName* pPlayerName, void* pData, dword pDataSize, dword pFlags );
TDX_PLAY::CREATEPLAYER()
[ component method ]
If you would like to submit additions or improvements to this page, click: darren_john_dwyer@hotmail.com. |
|