| DirectX SDK |
This topic pertains only to applications written in C++. In DirectX for Visual Basic, the data format of the DirectPlayAddress object is determined by which method of DirectPlayLobby3 is used to create it.
The following table shows the standard types of data chunks (DPCOMPOUNDADDRESSELEMENT) in a DirectPlay address created by using IDirectPlayLobby3::CreateCompoundAddress.
| GuidDataType | lpData |
|---|---|
| DPAID_ComPort | A DPCOMPORTADDRESS structure that contains all the settings for the COM port. The serial connection service provider will use this information to configure the serial port. |
| DPAID_INet | Null-terminated ANSI string containing an IP address (for example, "192.168.0.1") or a domain name ("microsoft.com"). The dwDataSize value must include the terminator.
If a blank address is supplied, the Internet TCP/IP connection service provider will use this information to enumerate sessions on the specified network address or to broadcast on the subnet. A blank address is a string that contains only the ANSI terminator (0x00) and has a length of 1 byte. |
| DPAID_INetW | Null-terminated Unicode string containing an IP address or a domain name. The dwDataSize value must include the terminator.
If a blank address is supplied, the Internet TCP/IP connection service provider will use this information to enumerate sessions on the specified network address or broadcast on the subnet. A blank address is a string that contains only the Unicode terminator (0x0000) and has a length of 2 bytes. |
| DPAID_INetPort | Integer containing the specific port number to use. See the section on selecting a specific port in the TCP/IP topic or see Firewall Support for information about using this DirectPlay address. |
| DPAID _LobbyProvider |
GUID that specifies the lobby provider this DirectPlay address applies to. |
| DPAID_Modem | Variable-length null-terminated ANSI string specifying which installed modem to use. The dwDataSize value must include the terminator. The modem service provider will use this modem without displaying a dialog box asking the user which modem to use. |
| DPAID_ModemW | Variable-length null-terminated Unicode string specifying which installed modem to use. The dwDataSize value must include the terminator. The modem service provider will use this modem without displaying a dialog box asking the user which modem to use. Use the IDirectPlay4::GetPlayerAddress method to determine which modems are available. |
| DPAID_Phone | Variable-length, null-terminated ANSI string containing a phone number. The dwDataSize value must include the terminator. The modem service provider will call this phone number on the IDirectPlay4::EnumSessions method. If no modem is specified, the first modem will be used. |
| DPAID_PhoneW | A variable-length null-terminated Unicode string (LPWSTR) containing a phone number. The dwDataSize value must include the terminator. The modem service provider will call this phone number on the IDirectPlay4::EnumSessions method. If no modem is specified, the first modem will be used. |
| DPAID _ServiceProvider |
The 16-byte GUID that specifies the service provider this DirectPlay address applies to. |
| DPAID_TotalSize | A DWORD containing the size of the entire DirectPlay address. This chunk is added automatically by CreateCompoundAddress. |