CELLGPRSCONNECTIONINFO

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This structure contains General Packet Radio Service (GPRS) connection information that is used in the initiation of GPRS calls. Use this structure to specify the parameters of a GPRS connection.

Syntax

typedef struct cellgprsconnectioninfo_tag {
  DWORD dwProtocolType;
  DWORD dwL2ProtocolType
  WCHAR wszAccessPointName[CELLDEVCONFIG_MAXLENGTH_GPRSACCESSPOINTNAME];
  WCHAR wszAddress[CELLDEVCONFIG_MAXLENGTH_GPRSADDRESS];
  DWORD dwDataCompression;
  DWORD dwHeaderCompression;
  char szParameters[CELLDEVCONFIG_MAXLENGTH_GPRSPARAMETERS];
  BOOL bRequestedQOSSettingsValid;
  CELLGPRSQOSSETTINGS cgqsRequestedQOSSettings;
  BOOL bMinimumQOSSettingsValid;
  CELLGPRSQOSSETTINGS cgqsMinimumQOSSettings;
} CELLGPRSCONNECTIONINFO, *LPCELLGPRSCONNECTIONINFO;

Members

• dwProtocolType
  Identifies the protocol type for the GPRS connection. May be one of the values listed in the following table.

  Value	Description
  CELLDEVCONFIG_GPRSPROTOCOL_ UNKNOWN	Unknown protocol type.
  CELLDEVCONFIG_GPRSPROTOCOL_X25	Unsupported protocol type.
  CELLDEVCONFIG_GPRSPROTOCOL_IP	Internet provider protocol type. Radio acts as a Point-to-Point protocol (PPP) server.
  CELLDEVCONFIG_GPRSPROTOCOL_IHOSP	Unsupported protocol type.
  CELLDEVCONFIG_GPRSPROTOCOL_PPP	Point-to-Point protocol (PPP). Frames are forwarded to the end server.

• dwL2ProtocolType
  Identifies the level-2 protocol type for the GPRS connection. May be one of the values listed in the following table.

  Value	Description
  CELLDEVCONFIG_GPRSL2PROTOCOL_ UNKNOWN	Unknown protocol type.
  CELLDEVCONFIG_GPRSL2PROTOCOL_NULL	Unsupported protocol type.
  CELLDEVCONFIG_GPRSL2PROTOCOL_PPP	Windows Embedded CE uses Point-to-Point protocol (PPP).
  CELLDEVCONFIG_GPRSL2PROTOCOL_PAD	Unsupported protocol type.
  CELLDEVCONFIG_GPRSL2PROTOCOL_X25	Unsupported protocol type.

• wszAccessPointName
  Specifies the logical name to select the GPRS gateway.

• wszAddress
  Specifies the packet address to use for the connection. If this string is empty, then a dynamic address will be requested.

• dwDataCompression
  Identifies the data compression setting for messages that are sent and received. May be one of the values listed in the following table.

  Value	Description
  CELLDEVCONFIG_GPRSCOMPRESSION_ UNKNOWN	Compression is unknown.
  CELLDEVCONFIG_GPRSCOMPRESSION_OFF	Compression is turned off.
  CELLDEVCONFIG_GPRSCOMPRESSION_ON	Compression is turned on.

• dwHeaderCompression
  Identifies the data compression setting for messages that are sent and received. For a list of possible values, see the list of values for dwDataCompression.

• szParameters
  Identifies protocol-specific parameters. Must be NULL terminated.

• bRequestedQOSSettingsValid
  TRUE if and only if cgqsRequestedQOSSettings is valid.

• cgqsRequestedQOSSettings
  GPRS Quality of Service (QOS) settings structure. If bRequestedQOSSettingsValid is true, cgqsRequestedQOSSettings is used; if bRequestedQOSSettingsValid is false, cgqsRequestedQOSSettings is not used.

• bMinimumQOSSettingsValid
  TRUE if and only if cgqsMinimumQOSSettings is valid.

• cgqsMinimumQOSSettings
  GPRS QOS settings structure. If bMinimumQOSSettingsValid is true, cgqsMinimumQOSSettings is used; if bMinimumQOSSettingsValid is false, cgqsMinimumQOSSettings is not used.

Remarks

This is used to specify a particular GPRS connection profile. To establish a connection, the characters in the GPRS_DEST_ADDRESS string must be a subset of the dial string passed to lineMakeCall. This will initiate a GPRS connection, applying the parameters in this structure. This dial string workaround allows applications to have more complete control over the GPRS parameters used for their connection.

Requirements

See Also

Reference

CELLDEVCONFIG

Concepts

Telephony Service Provider Structures