DPL_CONNECTION_SETTINGS

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.

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.

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.

Requirements

  Windows NT/2000/XP: Available as a redistributable for Windows 2000 and later.
  Windows 98/Me: Available as a redistributable for Windows 98 and later.
  Header: Declared in Dplobby8.h.