Welcome to
www.tdxlibrary.org
Home of the
the TDx_Library...
"RAD DirectX"
for
C++ Builder
...
- Description
The SendLobbyMessage method will send messages between lobby client and application.
Error values that can be generated are:
DPERR_APPNOTSTARTED
DPERR_BUFFERTOOLARGE
DPERR_GENERIC
DPERR_INVALIDINTERFACE
DPERR_INVALIDOBJECT
DPERR_INVALIDPARAMS
DPERR_OUTOFMEMORY
DPERR_TIMEOUT
- Parameters
Flags
The Flags parameter defines flags indicating the type of message being sent.
The described effect applies when the flag is set.
The default setting of zero indicates an application defined message is being sent.
-
DPLMSG_STANDARD
The message is a standard DirectPlay defined message.
The AppID parameter identifies the destination application for the message.
Set zero when the method is called from an application.
This is the identifier returned by TDx_PlayLobby::RunApplication().
Data
The Data parameter references the message data to be sent.
The standard DirectX message structures used when DPLMSG_STANDARD is set are:
typedef struct {
dword Type;
dword RequestID;
GUID Player;
GUID PropertyTag;
} TDPLMSG_GetProperty, FAR *LPDPLMSG_GetProperty;
typedef struct {
dword Type;
dword RequestID;
GUID Player;
GUID PropertyTag;
dword DataSize;
dword PropertyData[1];
} TDPLMSG_SetProperty, FAR *LPDPLMSG_SetProperty;
For the above structures, the following descriptions apply to their members.
Type
The type of system message that is being sent.
Possible values are DPLSYS_GETPROPERTY and DPLSYS_SETPROPERTY respectivly.
A system DPLSYS_GETPROPERTYRESPONSE or DPLSYS_SETPROPERTYRESPONSE will be triggered.
RequestID
An application defined unique identifier used to match requests to lobby responses.
Player
The GUID of the player the property applies to.
Non player specific information will have this set to GUID_NULL.
PropertyTag
The GUID of the property being set. Standard DirectX properties are:
DPLPROPERTY_LobbyGuid
DPLPROPERTY_MessagesSupported
DPLPROPERTY_PlayerGuid
DPLPROPERTY_PlayerScore
DataSize
The size of the property data.
PropertyData
A buffer of information that is to be interpreted based on the PropertyTag member.
DataSize
The DataSize parameter defines the size, in bytes, of the Data buffer.
- See Also
- Top
TDx_Play_Library v2.00 Component Reference
|
|
|
[ TDx_PlayLobby::SendLobbyMessage() ] [ next: SetConnectionSettings() ] [ prev: RunApplication() ] public:
virtual bool __fastcall SendLobbyMessage( dword pFlags, dword pAppID, void* pData, dword pDataSize );
TDX_PLAYLOBBY::SENDLOBBYMESSAGE()
[ component method ]
If you would like to submit additions or improvements to this page, click: darren_john_dwyer@hotmail.com. |
|