• This page in Spanish



• Overview
• Details of the TDx_Play_Library
• Components of the TDx_Play_Library
• More Information

The TDx_Play_Library is a library of 14 Borland C++ Builder (BCB) rapid application development (RAD) components
that "wrap" all available DirectPlay(tm) functionality into easy-to-use BCB Visual Component Library (VCL) components,
supplying a complete framework for harnessing all the power of DirectPlay(tm) and Borland C++ Builder.

These components make DirectPlay(tm) very easy to use, make DirectPlay(tm) work with Borland C++ Builder,
have many added extras designed to help you mix DirectPlay(tm) and Borland C++ Builder - quickly and easily.

All components come complete with full source code, project files, auto-installer, full [F1] context-sensitive help
covering all of DirectPlay(tm) plus additional features, and demos with full source code.

• Multi-Player
• Internet
• Local Area Network
• Dial-Up Connection
• Direct Cable Connection

• Realtime network message handling using BCB-style event notifications
• A new programming paradigm, rapid application development DirectPlay, or "RAD DirectX" for short.

• Fully optimized for BCB and the VCL
• A solution to integration problems between BCB and DirectX where necessary.
• Automatic error detection & redirection to easy-to-use OnError() events.
• Automatic callback handling & redirection to easy-to-use OnEnum...() events.
• Low latency (delay) and also for overall wrapping processes.

• An overview of the TDx_Library

The 14 TDx_Play_Library components :-

• supply advanced multiplayer networking support to BCB applications
• automatically handle everything related to DirectPlay(tm)
• are quite "smart" - they fully maintain everything required to make DirectPlay(tm) work very well inside BCB
• supply an easy to use toolset designed to remove the vast majority of effort required to utilize DirectPlay(tm)
• let you focus mostly on the creative side of using DirectPlay(tm) rather than the underlying SDK technology

• Simple management of everything related to DirectPlay(tm)
• Simple access to all available DirectPlay(tm) functionality
• Easy access to multiplayer networking
• Easy access to secure networking support
• Comprehensive BCB context-sensitive help [ press F1 in BCB ]

• Components of the TDx_Play_Library

The table below contains details on each TDx_Play_Library component, and links to individual reference pages :-

COMPONENT LOGO	COMPONENT NAME	WRAPPER TYPE	COMMENT
	TDPAccountDesc	Wrapper	The TDPAccountDesc component wraps a DPACCOUNTDESC structure. It holds the account identifier for the player in Unicode or ANSI form.
	TDPApplicationDesc	Wrapper	The TDPApplicationDesc component wraps a DPAPPLICATIONDESC2 structure. It is used when registering a lobby aware application and holds the launcher executable's name, session launcher's ID, non-localised application name, command line arguments, current directory, localised description, file name and path.
	TDPCaps	Wrapper	The TDPCaps component wraps a DPCAPS structure. It describes the capablities of a session or player including a message timeout value, capability flags, message header size, connection speed, a latency estimate and maximum values for packet size, local players and total players.
	TDPChat	Wrapper	The TDPChat component wraps a DPCHAT structure. It holds message data in either Unicode or ANSI format.
	TDPComPortAddress	Wrapper	The TDPComPortAddress component wraps a single DPCOMPORTADDRESS structure. It defines com port configuration details such as baud rate, which com port, as well as the flow control, parity and stop bit settings.
	TDPCompoundAddressElement	MultiWrapper	The TDPCompoundAddressElement component wraps multiple DPCOMPOUNDADDRESSELEMENT structures. It defines the address data along with the size and type of that data.
	TDPCredentials	Wrapper	The TDPCredentials component wraps a DirectX DPCREDENTIALS structure. It is used to hold the username, password and domain needed to connect to a secure server in Unicode or ANSI format.
	TDPLAppInfo	Wrapper	The TDPLAppInfo component wraps a DPLAppInfo structure. It is used to hold the name and identifier of an enumerated application.
	TDPLConnection	Wrapper	The TDPLConnection component wraps a DPLCONNECTION structure. It holds the details used to connect an application to a session. These details include the connection address, the address size, a create or join flag, the players name, the session description and which service provider to use.
	TDPName	Wrapper	The TDPName component wraps a DPNAME structure. It holds the friendly and the formal name of a player or group in ANSI or Unicode form.
	TDPSecurityDesc	Wrapper	The TDPSecurityDesc component wraps a DPSECURITYDESC structure. It describes the security settings of a session by defining the SSPI and Crypto API packages, the Crypto API type and the encryption algorithm.
	TDPSessionDesc	Wrapper	The TDPSessionDesc component wraps a DPSESSIONDESC structure. It defines the sessions nature as well as detailing its name and password, the application and instance identifiers, maximum and current player numbers, along with several user defined session properties.
	TDx_Play	Interface	The TDx_Play component wraps and manages an IDirectPlay4 interface. It creates TDx_Play objects and manages messages, sessions, groups and players. It can be used to add a group to a group, add a player to a group, cancel specific messages, cancel messages by priority, close a session, create a group, create a group within another group, create a player, remove a group from a group, remove a player from a group, delete a group, delete a player, enumerate service and lobby providers, enumerate the players in a group, enumerate the top groups of a session, enumerate the groups in a group, enumerate players in the session, enumerate sessions, retrieve session capabilities, retrieve a groups connection settings, retrieve customised group data, retrieve a groups descriptive flags, retrieve a groups name, retrieve a group owners ID, retrieve a group parents ID, count a players messages, count a sessions messages, retrieve a players account information, retrieve a players address information, retrieve player capabilities, retrieve customised player data, retrieve a players descriptive flags, retrieve a players name, retrieve the sessions properties, initialize a connection, create or join a session, retreive a message, create or join a secure session, send a message, send a chat message, set a groups connection settings, set customised group data, set a groups name, set a groups owner, set customised player data, set a players name, set the sessions properties, and launch a session. TDx_Play additions to IDirectPlay4 Properties: Created, ErrorValue, NumPlayers, PlayerEvents, PlayerIDs, UseAnsiString. Methods: Create, Destroy. Events: OnAddGroupToGroup, OnAddPlayerToGroup, OnChat, OnCreate, OnCreatePlayerOrGroup, OnDeleteGroupFromGroup, OnDeletePlayerFromGroup, OnDestroy, OnDestroyPlayerOrGroup, OnError, OnGeneric, OnHost, OnReceive, OnSecureMessage, OnSendComplete, OnSessionLost, OnSetGroupOwner, OnSetPlayerOrGroupData, OnSetPlayerOrGroupName, OnSetSessionDesc, OnStartSession. Callbacks: OnEnumConnections, OnEnumGroupPlayers, OnEnumGroups, OnEnumGroupsInGroup, OnEnumPlayers, OnEnumSessions.
	TDx_PlayLobby	Interface	The TDx_PlayLobby component wraps an IDirectPlayLobby3 interface. It manages applications and their associated data. It can be used to connect an application to a session, create a standard address, create a compound address, parse an address, enumerate address types, enumerate local applications, retreive the lobby connection settings, retrieve a lobby message, register a lobby aware application, launch an application, send a lobby message, set the lobby connection settings, unregister a registered application and wait for connection settings to be passed. TDx_PlayLobby additions to IDirectPlayLobby3 Properties: Created, ErrorValue, LobbyEvents, NumLobbies, UseAnsiString. Methods: Create, Destroy. Events: OnAppTerminated, OnConnectionSettingsRead, OnCreate, OnDestroy, OnError, OnGeneric, OnGetProperty, OnGetPropertyResponse, OnNewConnectionSettings, OnNewSessionHost, OnPlayConnectFailed, OnPlayConnectSucceeded, OnReceive, OnSetProperty, OnSetPropertyResponse. Callbacks: OnEnumAddress, OnEnumAddressTypes, OnEnumLocalApplications.