| Microsoft DirectX 9.0 SDK Update (Summer 2003) |
DPL_CONNECTION_SETTINGS Structure
Used to specify the settings you want to associate with a connection. These settings contain all the information required to create, initialize and connect/host a Microsoft® DirectPlay® object.
Syntax
typedef struct _DPL_CONNECTION_SETTINGS {
DWORD dwSize;
DWORD dwFlags;
DPN_APPLICATION_DESC dpnAppDesc;
IDirectPlay8Address *pdp8HostAddress;
IDirectPlay8Address *ppdp8DeviceAddresses;
DWORD cNumDeviceAddresses;
PWSTR pwszPlayerName;
} DPL_CONNECTION_SETTINGS, *PDPL_CONNECTION_SETTINGS;Members
- dwSize
- Size of the DPL_CONNECTION_SETTINGS structure. The application must set this to sizeof( DPL_CONNECTION_SETTINGS ) before using this structure.
- dwFlags
- The following flag can be specified.
- DPLCONNECTSETTINGS_HOST
- The application should host the session.
- dpnAppDesc
- Pointer to the application description that should be passed to the Connect or Host call when DirectPlay initialized.
- pdp8HostAddress
- If DPLCONNECTSETTINGS_HOST is not specified, this is the address of the session the client should connect to. If DPLCONNECTSETTINGS_HOST is specified, this member must be NULL.
- ppdp8DeviceAddresses
- This structure contains an array of pointers to device addresses. If DPLCONNECTSETTINGS_HOST is specified, this member will contain the addresses the host should listen on. If DPLCONNECTSETTINGS_HOST is not specified, this member will contain the address of the devices the client should use when connecting.
- cNumDeviceAddresses
- Number of addresses specified in the ppdp8DeviceAddresses member.
- pwszPlayerName
- Can be used to pass the player name you want the DirectPlay object to use when launching. This member can be NULL.
Structure Information
Header dplobby8.h Minimum operating systems Windows 98, Pocket PC 2002