Share via

CELLGPRSCONNECTIONINFO (Compact 2013)

  • Article

3/26/2014

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 Compact 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

You use this structure to specify a GPRS connection profile.

To establish a GPRS connection, the characters in the GPRS_DEST_ADDRESS string must be a subset of the dial string passed to lineMakeCall. When you use this method, your applications have more complete control over the GPRS parameters used for their connection.

Requirements

Header

tsp.h

See Also

Reference

Telephony Service Provider Structures
CELLDEVCONFIG